Writing Day

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: Sunday, May 22, 9am-5pm Pacific Time.
  • Location: Online conference platform.

Your Project Here

Add your project via a PR on GitHub or mailing us! You can always reach out to us if you have any questions or concerns before signing up.

Open Web Docs

Open Web Docs was created to ensure the long-term health of web platform documentation independent of any single vendor or organization. It’s supported by various organizations and individuals, and employs technical writers who create and maintain open documentation for the web platform. At the moment we’re focused on maintaining and improving MDN Web Docs.

At the Writing Day we’ll be working on MDN Web Docs and we’d love you to join us. Here are some of the projects we’ll be working on:

  • Content bug fixes: we’ll bring a list of issues that are suitable for first-time contributors to MDN.
  • Adding missing sidebars: we have a number of pages (30-100) in the Web API reference with no sidebar or with the wrong sidebar. To fix this we need to add the right macro call at the start of the page.
  • Writing some API overview pages: on MDN we have pages that provide an overview of a particular API. At a minimum, these need to list all the objects that make up the API and link to them.
  • Updating JavaScript code samples: many of our code samples use JavaScript features that are now considered outdated. We’d love to go through these and update them to use the modern style.

The MDN content is maintained in Markdown in a GitHub repository: https://github.com/mdn/content, and updates are made as GitHub pull requests, so to get started, you’ll need a GitHub account.

However, we’ll start with a session for complete beginners about how to write a pull request for a GitHub repository.

We’ll be available to help you understand exactly what’s needed for all these tasks and to help work through any problems. We’re also really interested in understanding where people have problems contributing to MDN and how we can make it easier. So if you do join us for Writing Day, please tell us about it - what worked and what didn’t, what was easy and what wasn’t - so we can improve the experience for contributors.

SolidJS

Solid is an open-source front-end framework for building web apps. We’ve been getting more use and attention than ever, so we formed a docs team to rework and rewrite our documentation to be as beginner-friendly and usable as possible.

Solid is the perfect project to get involved in if you’re interested in open-source, web development, or just want to see what outside-the-box documentation ideas we have in store!

We’re excited to meet you. Here’s what we’re up to and how you can help:

  • We have an existing docs site, and a new one we’ve just started. Our goal is to restructure and rewrite the content that’s on our existing docs site, which consists of a set of guides, an interactive tutorial, and an API reference page. We were thinking of following the Diataxis model for the new site, but we’d love your feedback on structuring our documentation.
  • We have a new, beginner-focused tutorial! The idea is for anyone with JavaScript experience to be able to use this tutorial to learn Solid. We’d love feedback on this, which you can leave with us or on our Issues page on GitHub.
  • If you see something on our new docs site that you want to change and you’re familiar with GitHub, feel free to directly make a PR by clicking the Edit button at the bottom of a page.
  • We’re looking for contributors! Whether you have no experience with web development or already use the framework, we’d love for you to join our open-source docs team and help make the #1 satisfaction-rated framework even more satisfying!

During the conference

Check out the Writing Day Cheat Sheet for a quick reference that you can use during the conference to make the most out of Writing Day.