From 7832783e9c05cce427c25f007fae72d285dd0fc2 Mon Sep 17 00:00:00 2001 From: Alfredo Beaumont Date: Mon, 3 Jun 2013 11:38:56 +0200 Subject: [PATCH] [doc] Some proposals for code organization and style --- HACKING.org | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/HACKING.org b/HACKING.org index 965014f..06db5fe 100644 --- a/HACKING.org +++ b/HACKING.org @@ -5,3 +5,11 @@ - =(jscl:bootstrap)= will generate jscl.js - Add tests - Open tests.html in your browser to see your failed tests +** Code organization, style, etc. +*** Every definition should include documentation and unit tests. +*** Definitions are organized in different files following CLHS chapters. +*** Inside every file definition ordering should follow each CLHS dictionary index. This should make easier to find what has already been defined and what has not been defined yet. +*** Definitions should follow CLHS naming (e. g., cons definition should be (defun cons (object-1 object-2) ...), not (defun cons (x y)) or (defun cons (obj1 obj2)). +*** Tests should follow the same organization as definitions. +*** CLHS examples can be used as tests. +*** Documentation strings should not be taken from CLHS (due to license issues). It is recommended to take them from SBCL instead of reinventing them. -- 1.7.10.4