FAQs for Fedora Docs contributors

[Dan Smith]

A central page with links in succession to the various pages would be
a huge help in getting started.

Also an explanation what each account you create does for you.

In a previous post to this list it was mentioned that many of the
users won't have a technical background. When creating an account the
step of adding the ssh pub key might throw the inexperienced users for
a short loop.  First you have to create the key. Easy enough to do
with keygen, then the second thing that might cause them difficulty is
getting to the file. Recent FF versions will not allow you to browse
to the dot dirs. With your pub key living in .ssh that can cause a bit
of a temporary quandry for a new user. Easily solved by either copying
the file up a dir or creating a symbolic link to the dir or file. So
it might be worth mentioning if we do have inexperienced users. Could
save them a bit of aggravation. To the non-technical user it appears
they do not have that dir as by default hidden dirs are not displayed
in the GUI file managers. Firefox's upload dialog won't traverse that
dir even if they can find it.  Most inexperienced users won't think of
using the CLI to look. If they do the ls -al won't come to mind
anyway.  Then if they can get to the dir the file they need doesn't
exist. Gotta put yourself in their place when they hit those
obstacles.

Another thing that would help I think would be a page with basic IRC
info. Most people this day an age use IM and many have never heard of
IRC. When I did the MMORPG thing I had to hand hold hundreds of users
while teaching them how to use IRC.  Been trying out pIdgin for IRC
and it seems to work pretty well so far. Pigin is installed on just
about everything. So might be a good idea to give a quick half page
rundown on how to set up pidgin for IRC, how to register a nic and how
how to join the fedora-docs channel.  IRC is obviously the best choice
for this kind of work. Many folks though will need an introduction too
it.

Right now I hit a dead end. I think I have all the necessary accounts.
Now what?  Can't edit anything, can't create a new topic, least
doesn't appear that I can.

Those are my first thoughts on the topic.


On 8/21/07, Karsten Wade <kwade at redhat.com> wrote:
> What are the frequently asked questions that we get from new
> contributors to this project? List ...
>
> What are some questions you might still have as a contributor?
>
> With stuff scattered all over the wiki, it could help new docs
> contributors to have one page with all the answers.
>
> - Karsten
> --
>         Karsten Wade              ^     Fedora Documentation Project
>  Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
>     quaid.fedorapeople.org        |          gpg key: AD0E0C41
> ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
>
> --
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe:
> https://www.redhat.com/mailman/listinfo/fedora-docs-list
>
>