start | all-pages
blockformat
While technically freeform, I like to follow a simple structure
for my blocks.
The first line gets a description of the block contents. For
code blocks, this starts with a comment with the block group,
followed by comments for the description.
I leave the line after the description blank. This is not
necessary, but I find it to aid in readability a bit.
The rest of the block is filled with the source code or text.
I recommend having each block focus on a particular word (or
small group of related words).