Writing Day

Each year we run an event called the Writing Day during the conference. This event is modeled after the concept of sprints, which are common in open-source conferences. The main premise is to get a bunch of interesting people in a room together and have them work towards shared goals.

To make the most out of the Writing Day, we recommend that you either come with a project, or be ready and willing to contribute to someone else’s project.

Here are some examples of projects that you might want to work on:

  • Open source software documentation

  • General documentation writing

  • Best practices manual (For your company, or the world)

  • Blog posts

  • Tips and tricks

  • Great works of fiction

  • Love letters

  • The Documentarian Manifesto

You get the idea.

All this adds up to a room full of smart people sharing your problems, your passion, and your goals. So be ready to learn some new things and to teach others what you know.

Even if you feel as though you don’t know that much, we know you have a lot to offer. Come surprise yourself with how much you can share.

Documenting a new project?

Check out our beginners guide to writing documentation. This should help you get started, and give you some ideas for how you can contribute to a project that you love.

Logistics

Please bring a computer or some other mechanism with which to create written words. We’ll be creating and editing content, so make sure that you have the tools you need to contribute.

Schedule

  • Date & Time: November Nov 16, 9am-6pm, with the conference opening reception in the same space from 17:00.

  • Location: We will be in the main ballroom.

Projects

  • anything else you fancy

Brainstorm user-oriented architecture

The website is currently organised around meetups, conferences, guides, etc – find ways to introduce user-oriented labels considering audience. Who is coming to the site, why? What are the goals of the site?

  • Learn about docs

  • Get involved with the community

  • Attend conference

  • Submit a conference proposal

  • Find a video of a talk that I saw

Improve navigation

Let’s discuss information architecture – can we organize the content better? Provide better navigation?

Help develop the Documentation Guide

Help reorganize the guide content, or write and edit topics. Check out Software documentation guide ahead of time and bring your ideas to the table!

Fix website issues

We have a list of issues on GitHub tagged as writingday that includes things like:

  • fix broken links (we have a lot of these)

  • improve the meetup pages

  • make a better video archive

  • add list of conference write ups for past conferences