Hacker News Reader

Nonetheless, it feels like there should still be an FAQ for actual FAQs. It's harder to maintain than other documentation?

View on HN

We've empirically found it harder. It's completely disconnected from everything else, and covers a wide range of things, and so it's very easy to get lost in the shuffle.

So assign the job to people who can focus on just that; community volunteers can often do a better job than the core team for an FAQ, because they are more in touch with people new to the language are confused about than core developers with deep knowledge of everything. It will be dynamic and questions/answers will become obsolete, so that has to be handled.

(I was the G++ FAQ maintainer back in the 1990s; yes, I'm old).

> So assign the job to people who can focus on just that

This requires having a person who can. We never had one.

> community volunteers can often do a better job than the core team for an FAQ

Absolutely! The original version was written by the community. After such a heroic effort, they couldn't maintain it. I believe it was a lack of time, not desire, but regardless, that's just how it goes.

Reply on news.ycombinator.com