Next StepsΒΆ
Cog could be avoided completely in the future versions or a ruby version could be used, making full use of heredocs as cog does not support arbitrary nesting. But that is not a priority. All you need is heredocs to define code and documentation chunks but that might increase the boilerplate.
Jinja-Cli, ERB, PHP can also be invoked from the command line as an alternate to cog.
Asciidoc example will also be added.
Cross referencing can be done manually with sphinx references but it could be automated.
Indexing by function signatures.
Search Support. Currently it is disabled in the themes but you can add it if you want.
Live reloading for docs.
Add diagramming support.
Port a small open source project.