README.txt

Put the Slack export here. Nothing in this directory is committed except this
file -- the export is several hundred megabytes and is kept separately.

Expected layout:

    source/
    └── slack/
        ├── users.json
        ├── selenium/
        │   ├── 2015-09-08.json
        │   └── ...
        └── selenium-tlc/
            ├── 2018-07-01.json
            └── ...

A Slack export arrives as a zip with one directory per channel and a pile of
day files inside each. Copy over the "selenium" and "selenium-tlc" directories
as they are, plus users.json from the top level of the export.

users.json is required -- it maps user IDs to the display names that appear in
the logs. Without it every message is attributed to something like U4C5DHACT.

Everything else in the export (channels.json, integration_logs.json, canvases,
other channels) is unused and can be left out.

Then, from the repository root:

    python3 scripts/build_slack.py

The older IRC logs under selenium/ are not generated from anything here. They
sit in a few shapes depending on where they came from -- flat .log files in
2011, plain month directories through 2015-08, and -irc suffixed months where
an IRC and a Slack record cover the same period. All are checked in as-is.
See the README for that history.