5 ms·
Interesting! Isn't it better to couple the documentation of a project to the source (e.g. in a `docs/` sub-directory) and just use markdown?
by ducktective 5y ago
Interesting!
Isn't it better to couple the documentation of a project to the source (e.g. in a `docs/` sub-directory) and just use markdown?
- chrisweekly 5y agoYep. GitLab's support for Mermaid in markdown is pretty nice. I'm looking into making my experiments with a Kroki server more official, at which point we'll have a robust platform for markdown-based, repo-internal, embedded-diagram-supporting docs.
- codazoda 5y agoMy docs often end up being related to multiple repos. So, although I want my docs in git, I’d prefer them to be their own repo.