On Mon, 2004-01-05 at 06:54, Jef Spaleta wrote:
Tom Diehl wrote:
FWIW when I was in barnes & nobel the other day I saw a book called "Fedora Companion" It is by Red Hat Press and contained a 2 CD set
of FC1 or
so the label says. I did not buy it but for those of you wanting a
stripped
down version to install it appears that it is already available. You
just
have to buy the book. :-)
it's actually called "Official Fedora Companion".
I had to do some fact checking to be sure this is (mostly) correct. Caveat lector: I am writing this as a Fedora docs project member and _not_ as a representative of Red Hat, Inc. I.e., I'm a writer, not a lawyer. :)
Red Hat Press is a sub-brand that Red Hat allows a given publisher to market under. So, the "Official Fedora Companion" is a general market book intended to incite people to use and participate in the Fedora Project, not to compete with e.g. Fedora docs project (FDP) or fedoranews.org. It is also not a product of the Red Hat documentation team.
AIUI, this book was well into the publication cycle when the initial Red Hat Linux project was conceived, and well before the merge with Fedora. Obviously, Nick didn't bang out this book from text editor to ink on the shelves in just a few short months.
If we want to mark anything from Fedora Project as Official, we'll have to set those standards ourselves and enforce them. In the end, none of us can stop a publisher from using the word in a title, no matter how unofficial it might actually be. Because of the dilution of the word "official", I'd recommend against using it for Fedora Project docs.
And that makes me wonder.... what is the status of the documentation subproject? I can't help be feel a little miffed that that a for cost book...an "Official" book...covering things like installing fedora is coming out before we have a rework of at least the Red Hat linux install guide...into the Fedora install guide. I'd personally like to see "Official" status to these sort of for cost reference resources be withheld until after the documentation
subproject
has a chunk of documentation available...in an effort to encourage writers and editors to contribute to the documentation subproject as a priority..over individual efforts. Of course, it would do my mind
some
good to know that the author of that "Official" companion book is
active
in the official documentation subproject as well. But even then, I'm still not sure I like the idea of deeming for cost resources
"Official"
before the official documentation project has at least an install guide...as a matter of policy to encourage people to work on the "official" fedora documents.
This isn't exactly a complaint, since i'm not as in the loop on the
doc
project as i could be..so my initial negative reaction could easily be based on ignorance of where things stand. But it did make me raise an eyebrow, because I want to see documentation coming out of the documentation subproject be THE priority documentation. If the people behind the documentation efforts like the "Official Fedora Companion" book and the tutorials at fedoranews.org aren't contributing directly
to
the official fedora doc subproject, that is a problem.
I think my above comments answer most of your questions about the "Official" book ... now I'll give a quick snapshot of what is happening with the docs project.
With participants from the Red Hat documentation team -- Tammy Fox as project lead, and regular input from Ed Bailey and myself, none of us being Red Hat Press authors ;-) -- the Fedora docs project (http://fedora.redhat.com/projects/docs/) was founded to provide the following documentation:
* Production and maintenance of * Fedora Core specific tutorials and howto documents * FC specific Documentation Guide * FC Installation Guide (IG)
List membership (fedora-docs-list@redhat.com) is at least 50 persons. Currently, list members are working on Anaconda documentation, Fedora security considerations, installing an SSH server with public/private key authentication, and various consumer electronics related tutorials for digital cameras, PDAs, and scanners. Although software translation (i18n) is a different project (and mailing list), translation tools and other toolchain discussions are popular topics.
The reason there are only two full-blown manuals boils down to avoiding a large mouthful for the FDP to chew on. IMHO and as a simple project member, this is the right thing to do -- we need to cut our teeth on bites that are appropriate to the team experience and current level of interaction. Remember that while most of the Fedora Core OS/kernel developers have been working together all along, projects like the FDP are essentially brand new, starting relatively from scratch.
However, there have been recent discussions amongst project members that we may have set our sights too low, and that people want real manuals produced by the FDP. Project members seem willing to take on the work. We're going to continue hashing this out, and if you are interested in more, list membership is open to all.
hth - Karsten