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
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\