Contributing to the Unofficial Fedora FAQ
I really like contributions to the FAQ! If you want to contribute,
there's two ways. The first is the easy way: just send me some
text! The second is even better: write the HTML yourself, and send
it to me! (See lower on this page for some guidelines
for HTML.) You can email me any contributions
that you have.
Below are some guidelines that I use personally when writing the FAQ. Don't
worry if you have a submission that doesn't fit all of them perfectly -- I
can help you out with it if you email me! When in
doubt, you can read the FAQ and see how current questions
Purpose of the FAQ: To help all computer users
use Fedora, by giving them the solutions for the most common problems in
- Target Audience: When I'm writing the FAQ, I think of
a reader who has never used Linux before, but wants to try out Fedora.
That way, new users can understand the FAQ, but advanced users can
still use it as a useful resource.
- The questions should be frequently asked.
For less-frequently-asked questions,
FedoraForum is a great
resource. For example, "I can't install Fedora on my brand new
Dell computer, what do I have to do?" would definitely
be frequently asked. "How do I write a C++ program in Fedora to
toast my socks?" would definitely not be frequently asked.
It's usually pretty easy to look around
FedoraForum and see if people
are asking the same question over and over. :-) When in doubt, you can
send me the question and I'll let you know if it's frequently asked!
- Simplicity: I aim to make the FAQ answers as simple as
possible. That means that if there's more than one answer to a question,
I will pick whichever one will be the easiest for a new user.
Sometimes it won't be the "best" answer, but it will always
work and be easy. For example, this is why I use yum in the FAQ instead
of apt -- yum comes with Fedora, and apt is an additional download, which
is more complexity.
This also means that I don't use words that new users won't
know. If I do have to use a word like that, I always explain it
before I use it.
- Brevity (Shortness): The FAQ should be very
brief. I like the idea that a new user can easily read over the
entire FAQ in a single sitting. I tend to remove sentences that aren't
- Fedora-specific: Usually, FAQ questions are about about
things that specifically affect Fedora users. There are a lot of
resources on the Internet for general Linux help, but not as many for
Fedora in particular. So, the FAQ tries to be a Fedora resource.
If you want to contribute a general question about Linux basics that would
be helpful for Fedora users, you can contribute it to the Fedora Basics
FAQ (coming soon)!
- Clarity: For many readers of the Fedora FAQ, English
is not a native language. So, I try to keep FAQ questions and answers as
clear as I possibly can, and I try to avoid complex words.
- Character: It's OK to have a little
fun, sometimes. Sometimes I will leave in sentences that don't need to
be there, because I think they add a little character to the FAQ, and make
it more enjoyable to read.
If you want to contribute directly with HTML, that makes me really
happy! Below are some guidelines that I use in the FAQ's HTML. Don't
worry if you can't get all of them in your HTML -- email
me and I can help. :-)
This FAQ is maintained by
Max Kanat-Alexander. That's max [at]
fedorafaq *dot* org or "mkanat" in the
You can help us keep this FAQ up to date! If you
discover an issue we don't cover, find any errors in the answers already
here or have a suggestion of some kind, please contact us and we'll get
"Fedora" is a registered trademark of Red Hat, Inc.
Visit the official Fedora Project