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).