GNOME Bugzilla – Bug 117796
Suggestion: FAQ should not be version or software specific
Last modified: 2011-06-08 21:59:20 UTC
Updating a central FAQ for every GNOME version is going to be silly, and there are lots of general GNOME questions that people ask all the time like, "Why have you removed all those options?" and "Does the Foundation make decisions for the hackers?" and things like that. Version-specific FAQs should be in the release notes published under each start/*/ page.
Agreed. I was going to turn it into general stuff and release-specific stuff. The plan was to have sections within the faq which were release-specific, but separate version-specific ones sounds more manageable.
Cool. You know, we could do the same thing with the documents that are on the learn page: <http://www.gnome.org/learn/>. Seems like the start/VERSION/ pages would be much better as "everything you ever wanted to gnow (ha ha) about GNOME <version>", so we could shift the user guide, version faqs, admin guide, release notes, etc., etc. to there. Then we can just interlink everything under start/ What do you think? I reckon it will be much better exposure for the docs. Not enough people have seen how cool they are! :-)
Seems a good way. I need to look at the pages, I suppose :) What would you think is "release-specific"? The more small docs which can be individually finished/maintained/updated/removed, the better, I think. So knowing general category ideas would be a big help. I have some ideas, but I have probably missed stuff. I don't use the websites much...
just off the top of my head, to start with: - release notes - user guide (lots references to release notes probably) - developer guide (basically links to docs and list of changes hackers should be aware of) - frequently asked questions (possibly inspired by "known issues" in the release notes) - admin guide (probably fairly static)