Document/finish @section decorator

[phodge]

First, plan how we want to tackle #23 so that we don't get feature overlap

• document how to use @sections
• capture errors on each section and prevent it stopping the whole script
• add a homely list-sections command which prints all the sections names, which repo they're part of, and their docstrings