Need Feedback on HOWTO wiki created by /me.
r.landmann at redhat.com
Sun Jul 12 22:40:10 UTC 2009
On 07/13/2009 06:06 AM, David Nalley wrote:
> Rudi and I have actually talked about needing to have a more concise -
> 'here is how you install fedora' document', akin to the one page
> release notes, and keep the 'install guide' as the complete reference
> addition. (esp now that it's almost 300 pages). We'd love to have help
> in working on this.
Absolutely! We noted the need for this in the lead up to Fedora 11 but
didn't have time to make it happen. We'll definitely have one for Fedora
12, and we'd love to have you on board, Kishan.
The only "gotcha" I'll point out at this stage is that as far as is
possible, the new guide should be built from chunks of XML that already
exist in the Installation Guide (and perhaps the Live CD documentation).
Sharing "code" between the full Installation Guide and the "Quick" guide
has the following advantages:
1. The chunks taken from existing documentation will already be
translated into a large number of languages (the IG is already partially
translated into around 36 languages)
2. We will only have to maintain the same step in one place (for
example, if we need to change something about keyboard selection in the
IG, we can then just copy that changed paragraph into the Quick guide)
3. Any maintenace changes that we make (from step 2 above) will only
need to be translated once, either in the "Full" guide or the "Quick"
guide, and we can copy the translation from one book to the other and it
will still work.
I'll pull something like this together in the next couple of days --
that will allow anyone who's interested in helping to identify and work
on any extra text that we need to link everything together.
What should we call this book? I'm thinking one of the following
* Fedora 12 Quick Installation Guide
* Fedora 12 Installation Quick Start Guide
* Fedora 12 Quick Start Installation Guide
More information about the fedora-docs-list