@@ -0,0 +1,44 @@
2+title = "Doccord Compliant Comments in all Generators"
6+grant_type = ["Bounty"]
7+grant_category = ["Core Dev"]
11+description = "Adapt the comments in the default generators to take advantage of the new doccord features."
20+The base desk comes with a variety of generators and threads that are useful for debugging and development. Documentation and usage guidance for these is scattered between inline comments (accessible via the `+help` generator) and [operators.urbit.org](https://operators.urbit.org/manual/os/dojo-tools) We propose to take advantage of the [newly released doccords](https://groups.google.com/a/urbit.org/g/dev/c/iqT0wgbFkPA) feature to consolidate the documentation and provide an introduction to the doccords utility for users.
24+For every "dojo tool" covered in [the docs](https://github.com/urbit/operators.urbit.org/blob/master/content/manual/os/dojo-tools.md), move the documentation into the source code in accordance with the doccord [style guide](https://github.com/urbit/urbit/blob/develop/pkg/arvo/lib/deco.hoon).
26+Rewrite the `+help` generator to display the relevant doccords.
28+Currently you need to do the following to see inline doccords.
31+=file -build-file %/path/to/file/hoon
35+This should be improved to be:
38++help %example-generator