From 9a7d34ad6f3df757ddcad8d2feb05f3428e61526 Mon Sep 17 00:00:00 2001
From: Katalina Okano <git@kat.cafe>
Date: Wed, 23 Sep 2020 21:14:26 -0400
Subject: [PATCH] docs: update README.md

---
 README.md | 29 +++++++++++++----------------
 1 file changed, 13 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 08c4ac9..70f7e3b 100644
--- a/README.md
+++ b/README.md
@@ -4,29 +4,26 @@ https://roleypoly.com
 
 Tame your Discord roles.
 
-### Need Help with the App?
+### Need Help with Roleypoly?
 
 📚 [Please read through our community documentation.](https://github.com/roleypoly/community-docs)
+😕 [Still confused? Talk to us on Discord!](https://discord.gg/PWQUVsd)
 
 ## Developing
 
 Roleypoly is a distributed system built with Go, React, Terraform, and Bazel.
 
-### Prerequisites
+This repo is currently being re-architected into a monorepo, so most processes might not be documented.
 
-This app is known to work on Mac, Linux, and on WSL. Maintainer is typically using WSL.
+### Quickstart
 
-- **Required Tools**
-  - Bazel
-  - Python (required for Bazel)
-  - Docker
-  - Docker Compose
-  - mkcert
-- **Optional Tools**
-  - _Not having these isn't going to stop you from working on the app. Bazel is magic._
-  - ibazel
-  - Go 1.15+
-  - Node 14+
-  - Yarn
+This repo can be quickly setup with [VSCode Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) or [GitHub Codespaces](https://github.com/codespaces). This will setup a fully featured Docker container for developing VSCode, including extensions.
 
-Setup a `.env` file copied from `.env.example`.
+If you'd like to not use either of those, a docker image can be built from `.devcontainers/Dockerfile`, or used normally via `docker.pkg.github.com/roleypoly/roleypoly/dev-container`. This use case is not actively investigated, but with tinkering, will work. Feel free to document this process and open a PR :)
+
+### Things to Know
+
+Bazel can make some tasks far harder normal. Ideally, these are automated over.
+
+- **Updating `go.mod`?**
+  - Run `hack/gazelle.sh` to regenerate `deps.bzl`.