News for hackers. Stuff that matters.
Re:Launch HN: Mintlify (YC W22) – Maintainable documentation... by hahnbee on Tuesday June 14, 2022 @04:15PM (#31745444)
Gotcha, apologies for all the questions - did you implement this for your company?

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.

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.

Re:Launch HN: Mintlify (YC W22) – Maintainable documentation... by hahnbee on Tuesday June 14, 2022 @08:29PM (#31747771)
Yeah, that honestly makes a lot of sense.