...
- Markdown (this is the format currently required for ToIP specifications)
- Kramdown vs. Markdown-it
- something else
Diagrams and images:
- Mermaid
- something else
Document rendering:
- Spec-up (this is our primary specification authoring tool)
- Respec
- MKdocs
- Docusaurus
- something else
...
- Method
- Publication deliverable / permanent links
- Spec-Up versioning and git/github strategy - see concern
Image versioning:
- a sustainable way of storing and referencing source and (auto)generated results of diagrams
- a layered structure - and overall maintenance of this documentation for different user groups and levels in a consistent way
- Broken links checker
Tooling:
- A set of GitHub actions that render publicly accessible:
- Webpages?
- Word documents?
- PDFs?
...