From ca06b25725a938f65e022f0749e641c3b4225879 Mon Sep 17 00:00:00 2001 From: Ben Sima Date: Tue, 8 Dec 2020 13:15:55 -0500 Subject: Update docs, remove useless README --- Biz/Dev.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'Biz') diff --git a/Biz/Dev.md b/Biz/Dev.md index 5c0d4ca..cff9464 100644 --- a/Biz/Dev.md +++ b/Biz/Dev.md @@ -40,10 +40,13 @@ as possible. Only after sufficient iteration such that interfaces are solidified and functionality is well-established should some code be promoted up the namespace hierarchy. -Boundaries and interfaces between namespaces should be small and +Start with small namespaces: use `Biz/Thing.hs` before `Biz/Thing/Service.hs`. +Try to keep all related code in one spote for as long as possible. + +Boundaries and interfaces between namespaces should be singular and well-defined. Likewise, the functionality and purpose of a particular -namespace should be small and well-defined. Following the unix principle -of "do one thing and do it well" is advised. +namespace should be singular and well-defined. Follow the unix principle +of "do one thing and do it well." Namespaces are always capitalized. I would prefer always lowercase, but `ghc` _really_ wants capitalized files, so we appeas `ghc`. In Scheme -- cgit v1.2.3