Red Hat Bugzilla – Bug 197909
Include a local copy of the FAQ along with the release notes
Last modified: 2013-03-13 01:42:41 EDT
Description of problem:
We have a fairly comprehensive FAQ in http://fedoraproject.org/wiki/FAQ
Link to FAQ but no local copy
Include a local copy linked from the release notes prominently
Let's get this converted to XML and have PO files available in advance of test3.
We'll need to do an update as we get closer, but hopefully it will still be much
easier for tranlators.
If we get the PO included in RELEASE-NOTES.po, then we can have the translated
XML output to a separate file that sits in fedora-release-note. I'd like to
have the FAQ linked from the left nav here:
... rather than buried at the bottom of the release notes and only findable from
One of the contributors is working on a new index.html page which will
prominently link to the FAQ.
Moving this to block the relnotes tracker but not the FC6 relnotes, as we have
done what we can for FC6.
OK, back to the beginning then ... we have a link to the FAQ but the content is
not local to the install. The original comment was that we need this
information available during installation time to answer installation related
FAQs, for people who cannot/do not have a system networked to the online version
of the FAQ.
The other school of thought contended that any content in the FAQ that is needed
during installation belongs in the release notes.
Can we do this?
1. Write up _all_ installation FAQs into directions in Docs/Beats/Installer
2. Pull this content directly into the FAQ with an [[Include()]]
Then we get to write and maintain one location.
Any information truly *needed* during installation needs to be in the Release
Notes. If it's needed to fix an installation bug (cf. FC6 bug with i586 kernel
installation), there's no way we can have that frozen for release anyway, a
chicken-and-egg problem. A link to the FAQ suffices, and your strategy is the
right one -- put notes in the Installer beat, and use for online FAQ as needed.
OK, there is now a link at the top of Docs/Beats/Installer that points at the
wiki/FAQ and wiki/Bugs/Common.
Agreeing with comment #5 ... so I put a link at the top of Docs/Beats/Installers
to point at wiki/FAQ and wiki/Bugs/Common (a more generic bug path to #REDIRECT