newdoc
newdoc copied to clipboard
The newdoc tool generates files formatted with AsciiDoc, which are used in Red Hat documentation.
Hi all, * latest release on GitHub: **2.14.0** https://github.com/redhat-documentation/newdoc/releases * latest tag on GitHub: **2.17.0** https://github.com/redhat-documentation/newdoc/tags I see two solutions: either drop the "releases" feature on GitHub for the project;...
We could use more force on the simplification in Satellite upstream. Specifically, we want our modules to start with the ID and avoid module metadata: ```patch - :_newdoc-version: 2.16.0 -...
Some of the _* attributes are separated with a blank line from each other or appear later in the template. For consistency reasons, can we move them up so that...
Hi :wave: When I create a new concept/procedure/snippet/reference, the created file contains a trailing newline: ``` $ newdoc --version Version: 2.14.1 $ newdoc -c my-concept.adoc [INFO] ‣ File generated: ./con_my-concept-adoc.adoc...
Add an option in newdoc to generate a valid xref to a file, in the recommended format. This could have two forms: * An xref to a selected existing file....
Add an option to rename an existing module: - Change the title - Change the ID and context attributes - Change the file name I expect this to be a...
Optionally, add a comment block near the start of the generated file that would store certain metadata useful to writers or to Pantheon. Internal metadata candidates: * Supported versions: ex.:...
Add an option that doesn't create a file, and only prints out the ID derived from the title. This can be useful for referencing modules, renaming modules, and other such...
To attempt to create a tool that can update documents to the latest version of the template with its standards.
Consider creating a publicly accessible web interface to some of the newdoc functionality. This would make newdoc more accessible to less technical people and could be pretty neat in general....