Slashdot Mirror


'Write the Docs' is a Conference for People Who Write Software Docs (Video)

There is this guy, Eric Holscher, who has been doing FOSS development for quite a while. He's been on GitHub since 2008, and got involved in Gittip not long after it started in 2012. Not long after that, Eric started thinking about how open source software developers have all kinds of conferences and have many communities they can join and learn from each other, while those who write documentation, especially for FOSS, typically work all alone in a vacuum.

So why not have a conference for documentation writers (and developers who want to hook up with writers who can help them make high-quality docs)? Don't limit it to FOSS, but make sure that's the emphasis. Call the conference 'Write the Docs' and have the first conference in Portland, Oregon, in 2013. Which is exactly what Eric did. A year later, a second 'Write the Docs' conference is scheduled in Budapest (Hungary) at the end of March, and the next Portland conference is set for May 5.

24 comments

  1. More docs by Anonymous Coward · · Score: 1

    That's good for you.

    1. Re:More docs by Hsien-Ko · · Score: 2

      oh man

    2. Re:More docs by K.+S.+Kyosuke · · Score: 1

      Unless docs are haram for you. ;-)

      --
      Ezekiel 23:20
  2. Not gonna read this by us7892 · · Score: 2

    I'm not going to read anything past the headline. Just like I don't read the documentation for anything...

    1. Re:Not gonna read this by Anonymous Coward · · Score: 1

      I don't know what you wrote because all I read was the subject.

    2. Re:Not gonna read this by msauve · · Score: 2
      Well, this phrase...

      and developers who want to hook up with writers who can help them make high-quality docs

      kind of brings new meaning to RTFM.

      I'm an old fart, but even I know that "hook up" doesn't nowadays mean what the author thinks it means.

      --
      "National Security is the chief cause of national insecurity." - Celine's First Law
    3. Re:Not gonna read this by Anonymous Coward · · Score: 0

      I'm a developer and I've hooked up with writers and found it worthwhile.

      However, honestly, I can't say I'm sure that higher quality docs resulted from it (although I can't discount that, maybe, a happy writer is a better writer which did therefore result in better documents).

  3. documen tationspeci is a wast of $ by Anonymous Coward · · Score: 1

    nobodyhere on /. needs and stupid doucmentgation specialkists! All porgrammers sort their salte are smart & skilled enough to wright great documenation in there code comments!

    Paying technical wrighters to documend code is a giant waist of money!

    1. Re:documen tationspeci is a wast of $ by Zontar+The+Mindless · · Score: 1

      Not so loud! I've house payments to make.

      --
      Il n'y a pas de Planet B.
  4. Irony by Megahard · · Score: 2

    Is a conference for writing documentation advertised with a video.

    --
    I eat only the real part of complex carbohydrates.
    1. Re: Irony by Anonymous Coward · · Score: 0

      Video is a form of documentation, you know.

    2. Re: Irony by grep+-v+'.*'+* · · Score: 2

      Video is a form of documentation, you know.

      Yes! Yes! That's exactly why I watch so much pr0n, just for the documentation. And I sometimes have to study for hours just to understand all of the nuances of the control functions.

      Oh, wait .....

      --
      If the universe is someone's simulation -- does that mean the stars are just stuck pixels?
    3. Re: Irony by Anonymous Coward · · Score: 0

      Get lost, loser.

    4. Re: Irony by K.+S.+Kyosuke · · Score: 1

      Get lost, losee

      Here, fixed that for ya.

      --
      Ezekiel 23:20
  5. Not new by Anonymous Coward · · Score: 0

    There's a ton of these conferences already, though maybe not with the FOSS emphasis. Here's one that's going on as we speak....and there's another every few weeks. There's a whole tech comm community if you're willing to go look for it.

  6. how to get there? by meeotch · · Score: 2

    I was going to go, but there were no directions, so I posted to a couple of forums. I got two conflicting answers, and one guy who called me a dumbass for not knowing and suggested I start my own conference if I didn't like the one they were having.

    1. Re:how to get there? by bob_super · · Score: 1

      That's not hard to find, it will be in the only bar that can store enough Gin, and won't throw people out when they change every karaoke lyric with "RTFM".
      The videos should be hilarious, in a cringe-worthy way.

  7. stupid headline by Anonymous Coward · · Score: 0

    stupid headline is a comment by an anonymous coward who thinks the headline is stupid.

  8. Wrong date, wrong YEAR! by Omega+Hacker · · Score: 2

    The link for the Portland conference is very clearly for *last years* conference (see the pesky '2013' in the URL??). The correct link is:

    http://conf.writethedocs.org/na/2014/index.html

    It is being held on May 5th and 6th, of *2014*.

    --
    GStreamer - The only way to stream!
    1. Re:Wrong date, wrong YEAR! by Roblimo · · Score: 2

      Somehow an edit went awry. Thanks for noticing. Fixed.

  9. Are there docs? by Blaskowicz · · Score: 1

    I'm looking for documentation about how to organize a conference about writing documentation, as well as docs that describe how such docs were created.
    Thanks.

  10. WTFM by Anonymous Coward · · Score: 0

    Shouldn't that be the title?

  11. shouldn't docs be integrated/included in the... by 3seas · · Score: 1

    ....source code? i.e. http://abstractionphysics.net/...

  12. My experience last year by LoisPatterson · · Score: 1

    Last year's conference had a mix of Python programmers (perhaps they predominated), technical writers with a strong technical focus (e.g., API documentation, developer documentation), and others (customer support, UI designers, etc.). I found it one of the most informative technical writing conferences I have attended. So I am going again this year without hesitation.