alt Hacker NewsMore importantly move your docs from anything else to pure markdown. Finally we are free from weird file formats and superfluous syntax for docs.
More importantly move your docs from anything else to pure markdown. Finally we are free from weird file formats and superfluous syntax for docs.
Pure markdown is fine until you need decent tables or structured metadata. Docs-in-repo sounds clean on paper, but the minute you need comments, suggestions, inline edits, permissions, and approvals from people who do not live in git all day, you are recreating half of Notion or Google Docs with plugins and glue code.
Then you ask marketing or support to open a PR. That is usually where the markdown honeymoon ends.