4 ms·
Really like this idea. I'm going to build something like this for the scripts I write for administration and operations. Script and documentation in the same fi
by reacharavindh 8y ago
Really like this idea. I'm going to build something like this for the scripts I write for administration and operations. Script and documentation in the same file. Pass it through another script and it spits out HTML documentation.
I suppose Sphinx(Python) or equivalent in other languages already do this, but the ease of use of Markdown is lucrative.
In my case Python - the language already recognizes lines starting with # as comments. Goes on to check out the rest of the stuff.
- vanderZwan 8y agoWhat's the benefit over having a doc comment style that can be transformed into documentation?