I promised to summarize my recent experience as a doc newbie and kickstart a barriers to entry thread, so here go’s!


My Contributor Persona

Since it reflects on my experience, here’s my background. I’m new to Linux, Fedora, Docbook, and git.  If I got any newer, I’d still be in the eggshell :-)


I do have XML documentation background so that made DocBook less painful.


A Baseline Example

I started out in the Fedora QA area, mostly because it seemed easier to contribute at the time.  As a QA tester, I could easily find a series of test cases and almost exactly what I needed to do in each case to get pass or fail on the test.  These tests started out quite simple (download the ISO and verify the size) and there were enough basic tests that I could keep busy, mark things as passed, or in the rare occassion, log a bug.  (NOTE - logging the bug was only easy because it was a variation of an existing bug so I could just clone and edit).


The parts of this experience that I think helped keep me involved and motivated:


My Fedora Docs Experience

Now we get to my shift over to docs. I poked at the doc project wiki, and while the front page seems quite clear, I stumbled off and on after that. I lurked a bit in irc, then eventually introduced myself and got a few pointers on what to learn (pointers to a git tutorial and docbook etc).  I floated around for some time after that and didn’t really get involved until someone mentioned the virtualization getting started guide needed work.  Since I was new to Fedora and all things Linux, I didn’t feel confident to volunteer prior to this, but I’m having to write about VMs in the day job so this seemed a good logical extension (aka something I knew a little bit about).  After that, it was fits and starts and fubars with git (some quite recent :-).  I think I’ve got it down now, but time will tell!


Fedora Docs Barriers to Entry

After that long-winded tale, here’s what I think the barriers are, at least for someone with my experience:


For the doc projects wiki - I found different paths through it, whether I was starting from the main docs project page, or googling for information and landing on some random page.  I also didn’t find out about the fedorapeople site until grundblom started using it (my fellow traveller on the doc newbie path in the virtualization getting started guide).  


I will also say it helped very much to have another new doc contributor with me along the way.


Anyway, that’s my tale for today!


Sandra