tilnow · necopinus · Sep 14, 2020 · Sep 22, 2020 · Sep 25, 2020 · Sep 26, 2020
diff --git a/.gitattributes b/.gitattributes
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -0,0 +1,25 @@
+name: Update SVG
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  update-svg:
+    runs-on: ubuntu-latest
+    name: Update SVG
+    timeout-minutes: 15
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: Setup dependencies
+        run: |
+          sudo apt-get install graphviz
+      - name: Create new SVG
+        run: |
+          sed -E -f macros.sed infrastructure.dot | dot -Tsvg > infrastructure.svg
+      - name: Commit changes
+        uses: elstudio/actions-js-build/commit@v3
+        with:
+          commitMessage: Updated infrastructure diagram SVG
diff --git a/README.md b/README.md
@@ -1,2 +1,32 @@
-# tilnow.github.io
-prototype documentation tool for yakcollective IT infrastructure
+# Yak Collective IT infrastructure map
+
+Prototype documentation tool for [Yak Collective](https://yakcollective.org) [IT Infrastructure](https://roamresearch.com/#/app/ArtOfGig/page/6fhTlx1p_).
+
+## Symbol key
+
+| Symbol              | Macro              | Meaning                                                                                |
+|:-------------------:|:------------------:|:-------------------------------------------------------------------------------------- |
+| Double Green Circle | `STATIC_DATA`      | Website or service that functions as a (relatively) static data source/destination     |
+| Green Oval          | `EXTERNAL_SERVICE` | Externally-facing web service used by YC members/participants (and sometimes others)   |
+| Blue Oval           | `INTERNAL_SERVICE` | Internally-facing web service used by few YC members (sometimes not accessible at all) |
+| Blue Rectangle      | `APPLET`           | A function, service applet, or internal tool; contained by and run by some service     |
+| Red Line            | `USER_DATA`        | Manual data flow (someone creates an account, reviews a list and takes action, etc.)   |
+| Black Line          | `AUTO_DATA`        | Automatic data flows (service takes action based on a timer, webhook, etc.)            |
+
+## Development
+
+Most (all?) browsers restrict how JavaScript can access `file://` URLs, even for HTML files opened directly from the file system. For this reason, you'll need to fire up a local web server to work on `index.html`, etc. Python 3 makes this easy:
+
+```bash
+python3 -m http.server 8080
+```
+
+Then go to <https://localhost:8080/index.html> to view the infrastrucutre diagram. Reload after making any changes.
+
+## Build
+
+To generate an SVG for Roam, use:
+
+```bash
+sed -E -f macros.sed infrastructure.dot | dot -Tsvg > infrastructure.svg
+```
diff --git a/_docs/blogs.md b/_docs/blogs.md
diff --git a/_docs/calandar.md b/_docs/calandar.md
diff --git a/_docs/calbot.md b/_docs/calbot.md
diff --git a/_docs/carl.md b/_docs/carl.md
diff --git a/_docs/cname.md b/_docs/cname.md
diff --git a/_docs/create_post.md b/_docs/create_post.md
diff --git a/_docs/deploy.md b/_docs/deploy.md
diff --git a/_docs/discord.md b/_docs/discord.md
diff --git a/_docs/dns.md b/_docs/dns.md
diff --git a/_docs/docs.md b/_docs/docs.md
diff --git a/_docs/editme.dot b/_docs/editme.dot
diff --git a/_docs/facebook.md b/_docs/facebook.md
diff --git a/_docs/feedupdates.md b/_docs/feedupdates.md
diff --git a/_docs/forms.md b/_docs/forms.md
diff --git a/_docs/github.md b/_docs/github.md
diff --git a/_docs/gmail.md b/_docs/gmail.md
diff --git a/_docs/hostproj.md b/_docs/hostproj.md
diff --git a/_docs/ifttt.md b/_docs/ifttt.md
diff --git a/_docs/index.md b/_docs/index.md
diff --git a/_docs/internet.md b/_docs/internet.md
diff --git a/_docs/invite.md b/_docs/invite.md
diff --git a/_docs/jekyll.md b/_docs/jekyll.md
diff --git a/_docs/knack.md b/_docs/knack.md
diff --git a/_docs/linkedin.md b/_docs/linkedin.md
diff --git a/_docs/mdfiles.md b/_docs/mdfiles.md
diff --git a/_docs/netlify.md b/_docs/netlify.md
diff --git a/_docs/netlifyrt.md b/_docs/netlifyrt.md
diff --git a/_docs/newby.md b/_docs/newby.md
diff --git a/_docs/newuserdata.md b/_docs/newuserdata.md
diff --git a/_docs/prune.md b/_docs/prune.md
diff --git a/_docs/reminders.md b/_docs/reminders.md
diff --git a/_docs/rendered website.md b/_docs/rendered website.md
diff --git a/_docs/roam.md b/_docs/roam.md
diff --git a/_docs/substack.md b/_docs/substack.md
diff --git a/_docs/twitter.md b/_docs/twitter.md
diff --git a/_docs/usercont.md b/_docs/usercont.md
diff --git a/_docs/website.md b/_docs/website.md
diff --git a/_docs/websites.md b/_docs/websites.md
diff --git a/_docs/welcomer.md b/_docs/welcomer.md
diff --git a/_docs/welcoming.md b/_docs/welcoming.md
diff --git a/_docs/yak_shaver.md b/_docs/yak_shaver.md
diff --git a/_docs/yakyak.md b/_docs/yakyak.md
diff --git a/_docs/zapier.md b/_docs/zapier.md