about summary refs log tree commit diff stats
path: root/tools/Readme.md
diff options
context:
space:
mode:
authorKartik Agaram <vc@akkartik.com>2019-12-08 23:16:33 -0800
committerKartik Agaram <vc@akkartik.com>2019-12-08 23:31:05 -0800
commit2249e605c19f0dbe0c34c1c4f635b802f56dc535 (patch)
tree0d110f9a5798ca6ec55ee3270bddf01834de9a8f /tools/Readme.md
parent2a2a5b1e43b6aa650a41ab1ec68d9778c14cb649 (diff)
downloadmu-2249e605c19f0dbe0c34c1c4f635b802f56dc535.tar.gz
5805
Diffstat (limited to 'tools/Readme.md')
-rw-r--r--tools/Readme.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/tools/Readme.md b/tools/Readme.md
index fd889ec5..9e59dabe 100644
--- a/tools/Readme.md
+++ b/tools/Readme.md
@@ -22,3 +22,15 @@ These are built lazily.
   ```
   tools/treeshake_all
   ```
+
+### Notes to self: constraints on the tools/ directory
+* Don't overwhelm the initial view of the project with lots of crap in the
+  root directory.
+* Directories go up top in the github view, so too many sub-directories are
+  also overwhelming.
+* Don't increase increase build time too much; everything in `tools/` shouldn't
+  be automatically built.
+  * stuff needed all the time is built from root directory.
+* `tools/` contains many independent things; don't make it hard to see
+  boundaries. Ideally just one source file per tool. If not, give related
+  files similar name prefixes.