Item9702: Document all template directives and macros
While editing templates, I ran across a few apparent macro invocations (template directives? how does a user distinguish?) that weren't documented in System.Macros
- 17 Sep 2010
George has started a great initiative to get these things (1) identified and (2) documented. I'd like to add a second step:
These template tokens have always been a problem; they are usually the result of a coder not fully understanding how to use templates just hacking in the simplest thing. The more we can do to eradicate these stains, the better.
For example, the ubiquitous SPLIT token could be replaced by three macro definitions, top, repeat and bottom. Of course the use of thse macros also need to be documented.
- 18 Sep 2010