start | all-pages
commentingblocks
Writing comments on your code is a good idea. There are a few
strategies you may wish to consider.
You can write *InlineComments. I do this for *StackCmomments in
words, and to occasionally explain what I'm doing.
For general comments, I like to have some blocks prior to the
code that explain anything relevant.
For word-specific comments, a traditional approach is to use
*ShadowBlocks. This would involve alternating between blocks
with code and blocks with descriptions of the code on the
previous block.