Slashdot Mirror

← Back to Stories (view on slashdot.org)

Open Source Writers Group

Posted by ryuzaki0 on from the writing-for-free-hire dept.

dria writes "The Open Source Writers Group (OSWG) is a project started to help writers find OS projects for which they can volunteer, and to help OS projects find the writers they need. Writers and editors who are willing and able to volunteer their efforts similarly find it difficult to identify OS projects that need them. This indicates a communications gap that must be addressed. The OSWG project has been created to help fill that gap. " I think we all realize that the Open Source world needs more of this-we've got a some rough edges, and people like this are needed.

7 of 15 comments (clear)

  1. Re:There are three types of writers in this world. by gavinhall · · Score: 2

    Posted by polar_bear:

    And those who can't read between the lines...

    I was one of the people who signed up, and I listed my tech skills so people would realize that I could understand the concepts of OS projects even if I'm not a coder.
    I listed my degrees because I wanted people to know that I can write docs that anyone could read. Instead of bitching about it why don't you join the project and suggest something?

  2. Good Idea! by Bruce+Perens · · Score: 2
    Good idea.

    Every major publisher in this business is willing to pay you to write books with Open Source Licenses, if you are willing to write them.

    You'll need a writing sample for these publishers. Produce your writing samples, and hone your skills, by writing documentation "gratis" for an Open Source project. This group will help you do it!

    Thanks

    Bruce

    --
    Bruce Perens.
  3. There are three types of writers in this world... by Stargazer · · Score: 4
    ... those who can count and those who can't. :)

    In all seriousness, though, I think that every project in this community needs to consider what kind of documentation they need to write. I'm sure you've noticed a stark difference in the documentation of Windows and Linux programs. This is because the Windows community seems to have collectively decided that the geeks can fend for themselves; they're writing for the people who fear that clicking any button causes an irrevocable change in the computer that will mess it up.

    Unfortunately, the Linux community seems to have collectively decided to write for the people who know very well how to work a computer, and want to know how to do the real juicy shtuff faster and better. The Linux Documentation Project is full of examples of these. Mind you, many of the HOWTOs on there are great, and easy for me to understand with minimal Linux experience -- but I've been comfortable with a computer since I was four years old, and I have no problem placing ideas of real objects with the abstract terms. I have a feeling that there are many people whom would be confused by even the most basic of HOWTOs (humourous ones excepted :) ), let alone the trickier ones.

    Browsing through the list of writers who have applied for the job, it doesn't seem like this project is making any attempt to fix this problem. For their biographies, they note things like degrees, almost any technical experience, and listings of programs they're familiar with. Unfortunately, none of them speak of their ability to communicate simply and easily with the computer illiterate.

    Advanced documentation is great. Otherwise, nobody would get sendmail configured. However, if we want people to consider free operating systems, we don't need to dumb them down -- we need to make our documentation "user-friendly." I would much prefer to see a real attempt to address larger problems than provide another means to ease communication between geeks who want to write for geeks.

    • Stargazer
  4. Re:There are three types of writers in this world. by dria · · Score: 3

    Browsing through the list of writers who have applied for the job, it doesn't seem like this project is making any attempt to fix this problem. For their biographies, they note things like degrees, almost any technical experience, and listings of programs they're familiar with. Unfortunately, none of them speak of their ability to communicate simply and easily with the computer illiterate.

    One of the main skills most technical writers must first develop is the ability to write clear, concise, user-oriented documentation (in the software industry, at least). I think perhaps none of us have put this in our mini-bios on the OSWG site because for us (experienced tech writers) this sort of thing almost "goes without saying". It is a valid point, of course, and I'll bring it up on the list to see if any of the writers/editors wants to add this sort of information to their bio.


    - deb

  5. MetaLab: Homes for OpenSource Projects by pjones · · Score: 2

    We've hosted several open source projects ( Linux, Linux Documentation Project, GGI and more -- even WAIS and Mosaic in ancient days).
    We're open to supporting more projects. So if you have some that need www, ftp, mailing lists etc, drop us a note at webmaster@MetaLab.unc.edu

    --
    Certified Black Helicopter Pilot *** Unwitting Dupe of One World Gov'ment
  6. Re:There are three types of writers in this world. by Athos · · Score: 2
    We need, essentially, documentation that can be approached in many ways, with assistance for newbies of differing levels that doesn't get in the way of the main document itself. Isn't this what hypertext is good for?

    I'm keeping getting this vision of an intensely-linked set of documentation. In some ways, [Everything] has some of the same look and feel. Of course, its charter is completely different.

    Or maybe I should cut down on the sugar.

    --

    --

    --
    The Internet is the Suppository of All Knowledge. You get it in the end.

  7. Re:Clearing house for coding too? by eey0re · · Score: 2

    Have you visited the FSF?

    If not this link my please you :)
    http://www.fsf.org/help/help.html

    HAve fun :)

    Ells