boulder: Consider a strategy for adding documentation to recipe options

[ermo]

We have a well known documentation deficit.

We should consider how we might auto-generate documentation from the source for relevant options and then convert all options to use that documentation format for consistency.

Related PR: #501