Summer of Documentation Ends

Earlier I mentioned an initiative started by the Ubuntu Forums Beginner Team called “The Summer of Documentation”. With the summer pretty much over with the coming of Labor Day in the United States, The results are in and they are really not as spectacular as we had hoped.

27 Wiki pages were cleaned up, expanded and brought to “standard” by 4 people. Another page is basically completed but not finished by another author, and there is still a list of pages left to complete. This list was established as an initial sweep and we had hoped to complete much much more than we have accomplished.

So what went wrong? That’s a pretty difficult question to answer. My thoughts are that the failure of the project can be “blamed” on a few different things:

  1. Failure to advertise and gain community support.
  2. Not having a good plan to get workers started
  3. Lack of clear cut goals and targets
  4. Volunteer burnout

These items are common to just about any volunteer project and many of them could have been avoided if we as a team had thought things out a little more. Since improving the Wiki is a colossal but worthwhile task, I am willing to give it another go with a little more thought and organization. I truly believe that given the large pool of potential volunteers that may be reached through the forums, using the forums as the basis for this effort is the way to go. It is also a lot easier to get exposure and coordinate the project on the forums than it would be through Launchpad or IRC.

Stay tuned for further developments as I try to get the ball rolling on the forums. I’ll need some help getting it going, as well as some folks willing to act as points of contact and mentors for the inevitable folks that say “Sure, I’d love to help but have no idea on how to contribute”.

About these ads

8 Responses to “Summer of Documentation Ends”


  1. 1 Vek September 1, 2008 at 6:20 pm

    5. Writing documentation is boring to most coders, and any pure volunteer based service tends to get the fun stuff done before the boring stuff.

  2. 2 Mikey September 1, 2008 at 6:55 pm

    Failure to advertise might be the understatement of the summer. Never heard or read anything about this project.

  3. 3 rawsausage September 3, 2008 at 8:54 am

    0. If using of software requires documentation, the usability of the software is broken.

  4. 4 Old Soldier September 3, 2008 at 8:58 am

    rawsausage: in a word, fail. In two: epic fail. Any software of more than minuscule complexity requires documentation

  5. 5 morraye September 6, 2008 at 7:31 am

    I’ve never heard of something like the summer of documentation.
    I have had a sea of time… and didn’t know I could’ve been contributing to the Ubuntu project :(

    How I could help or on what subject is still a shot in the dark, as I’m not an ubuntu-pro.
    I’ll spit this out, and will try to do my part) ;)

  6. 6 Old Soldier September 7, 2008 at 12:57 am

    morraye,
    Helping with the wiki is pretty easy . All you need is a launchpad account and some free time. The guys on the Ubuntu Forums Beginner team can help you get started and if you want to move on from there you can always join the Wiki team.

  7. 7 mpiasecki September 8, 2008 at 4:02 pm

    Summer of documentation… never heard of it.


  1. 1 Lienuks.nl » Schoonmaakoperatie online Ubuntu-documentatie mislukt Trackback on September 15, 2008 at 3:27 am

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s





Follow

Get every new post delivered to your Inbox.

%d bloggers like this: