Re:Launch HN: Mintlify (YC W22) – Maintainable documentation...
by dllthomas on Tuesday June 14, 2022 @07:09PM
(#31747126)
> apologies for all the questions
No worries at all, it's half of what we're here for :)
> did you implement this for your company?
On a couple repos, yeah.
> many of the comments prefer to have documentation in the repo
I think there's a lot of us, but I also think we're more likely to want to talk about it, so it seems like there's more of us than there are.
I should say that I think most everyone's on board with a small amount of developer facing docs in the repo, especially a README and build instructions; whereas if I had my druthers, it'd even include pamphlets the sales team takes to conferences.
That's interesting that the reception you got was primarily against documentation inside a repo. Maybe Gitbook could've been a good compromise? I recently made this post on reddit https://www.reddit.com/r/devops/comments/v6yuu5/whats_your_d... and many of the comments prefer to have documentation in the repo.