3 ms·

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

• steveklabnik 7y ago
  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.
  • not2b 7y ago
    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).
    • steveklabnik 7y ago
      > 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.