FAQs for Fedora Docs contributors

[Karsten Wade]

On Wed, 2007-08-22 at 12:27 -0500, Dan Smith wrote:
> A central page with links in succession to the various pages would be
> a huge help in getting started.

http://fedoraproject.org/wiki/DocsProject/Join
http://fedoraproject.org/wiki/DocsProject/Join/CheckList

How would you improve those?  I think they address all your items below:

> 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.

http://fedoraproject.org/wiki/DocsProject/Join/CheckList

Where would you link that in?  It does not seem to be on
DocsProject/Join nor on DocsProject.

So far, I think these aren't FAQ items.  The instructions and links are
there, or should be.

- Karsten
-- 
        Karsten Wade              ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
    quaid.fedorapeople.org        |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\