HelpOut
HelpOut copied to clipboard
Readme creation / cleanup update
Is there a way to create README.MD like PlatyPS does?
I tried using Wiki, but I don't see any results. Also is it possible to clear any deleted commands from doc?
@PrzemyslawKlys
For creating the README:
I normally do this by hand / with PipeScript's help (see almost any repo's README.ps.md). This allows me to hand-craft most of the content I want and templatize stuff like command tables and examples.
I haven't found a "perfect" default for this yet. I'm open to suggestions on a "good enough" default.
For deleting the help content that's no longer "correct"
This one is a trickier problem. The long story made short is that it's easy to clear a directory, and that would prevent manually editing docs (which would be bad). It's very hard to figure out that a file has become an orphan.
I'm open to suggestions here. Changes would have to be tracked in an additional file in order for us to know that "the file was generated by the last build, but not this build".
Hope this helps / Lemme know what you think