News for hackers. Stuff that matters.
Re:Launch HN: Mintlify (YC W22) – Maintainable documentation... by kaycebasques on Tuesday June 14, 2022 @05:08PM (#31746124)
> In the idealized straight-forward elaboration, then, all docs would live in the repo, but I haven't worked with a team that was on board with that

In case you're thinking about productizing your work I just want to give you a little encouragement that there are a lot of companies OK with having docs live alongside code. See Google's g3doc [1] for example. See also the docs as code movement.

[1] https://www.usenix.org/conference/srecon16europe/program/pre...

Re:Launch HN: Mintlify (YC W22) – Maintainable documentation... by hanyiwang on Tuesday June 14, 2022 @05:16PM (#31746203)
Thank you for sharing the article! We definitely don't see companies having all docs in their repos, but strongly believe that there should be stronger ties between docs and code (and more transparency in docs in general)

It's a really hard problem to solve, but we believe that there will be a product that will crack it (even if it's not what we have right now)

Re:Launch HN: Mintlify (YC W22) – Maintainable documentation... by dllthomas on Tuesday June 14, 2022 @07:12PM (#31747151)
Thanks! At the moment it feels much too small to productize; virtually all of the complexity is the CI integration, and even that is small.