summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorOmar Rizwan <omar@omar.website>2023-03-17 05:44:16 +0000
committerOmar Rizwan <omar@omar.website>2023-03-17 05:44:16 +0000
commit8737cedeb553565e3f0bb9fda2eddf1ed41a400d (patch)
treedcfb14529023e799b99668a1a2e8689f98558fe3 /docs
parentLink style guide, delete hw.md (diff)
downloadfolk-8737cedeb553565e3f0bb9fda2eddf1ed41a400d.tar.gz
folk-8737cedeb553565e3f0bb9fda2eddf1ed41a400d.zip
virtual vs tcl note in style guide
Diffstat (limited to 'docs')
-rw-r--r--docs/tcl.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/tcl.md b/docs/tcl.md
index 61755f26..34842cdd 100644
--- a/docs/tcl.md
+++ b/docs/tcl.md
@@ -26,6 +26,16 @@ puts [add {*}$numbers]
## Style guide
+### Tcl code vs. virtual programs vs. printed programs
+
+In general, avoid adding new .tcl files to the Git repo. Pure Tcl
+libraries are an antipattern; we should only need them for the hard
+core of the system.
+
+Most new code (both libraries and applications) should be virtual
+programs (which ilve as .folk files in the virtual-programs/
+subfolder) or printed programs.
+
### Folk
- Use complete sentences when you word your claims and wishes.