Bug 197909 - Include a local copy of the FAQ along with the release notes
Summary: Include a local copy of the FAQ along with the release notes
Alias: None
Product: Fedora Documentation
Classification: Fedora
Component: release-notes
Version: devel
Hardware: All
OS: Linux
Target Milestone: ---
Assignee: Release Notes Tracker
QA Contact: Karsten Wade
Depends On:
Blocks: fc-relnotes-traqr
TreeView+ depends on / blocked
Reported: 2006-07-07 05:43 UTC by Rahul Sundaram
Modified: 2013-03-13 05:42 UTC (History)
3 users (show)

Clone Of:
Last Closed: 2007-02-12 03:00:00 UTC

Attachments (Terms of Use)

Description Rahul Sundaram 2006-07-07 05:43:12 UTC
Description of problem:

We have a fairly comprehensive FAQ in http://fedoraproject.org/wiki/FAQ

Actual results:

Link to FAQ but no local copy

Expected results:

Include a local copy linked from the release notes prominently

Comment 1 Karsten Wade 2006-07-26 16:37:21 UTC
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
the ToC.

Comment 2 Paul W. Frields 2006-09-10 22:15:46 UTC
One of the contributors is working on a new index.html page which will
prominently link to the FAQ.

Comment 3 Karsten Wade 2006-09-23 19:07:39 UTC
Moving this to block the relnotes tracker but not the FC6 relnotes, as we have
done what we can for FC6.

Comment 4 Karsten Wade 2007-02-10 17:33:50 UTC
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.

Comment 5 Paul W. Frields 2007-02-10 20:31:53 UTC
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.

Comment 6 Karsten Wade 2007-02-12 03:00:00 UTC
OK, there is now a link at the top of Docs/Beats/Installer that points at the
wiki/FAQ and wiki/Bugs/Common.

Comment 7 Karsten Wade 2007-02-12 03:02:37 UTC
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

Note You need to log in before you can comment on or make changes to this bug.