It's a few years old, but I think you might find this useful as a starting point. It's a tips and techniques article on creating Maple documents.
As for document blocks, I find that they are good to have because the make document mode work nicely - all those context menu operatoins remain hidden, but we've found that there are very few times when they need to be manipulated manually. The only case I can think of is if I want a result appearing in the middle of sentence. For general readabiltiy, collapsed sections, code edit regions, buttons, and startup code do a good job keeping stuff hidden but accessible.