Hacker News new | ask | show | jobs
by zeddabaeen 2835 days ago
@stockkid hey! This works great for small dev teams, but once you get technical writers around and the team gets bigger, static documentation just doesn't cut it and is unable to scale with the demand. Hugo is amazing, but this is the same thing with buying your own hardware and racks, or hosting with Amazon. It's all about the managed service and peace of mind! Thanks, Z
1 comments

> once you get technical writers around and the team gets bigger, static documentation just doesn't cut it and is unable to scale

I feel that this is not convincing because docs for large software projects are also built using static site generators and git (e.g. docker).

In my case, we had many devs including a full-time technical writer contributing to the doc using Hugo and GitHub pull request and had no problems. I am curious what you think the bottlenecks of static documentation are.