CC Open Source Blog

WordPress Base Theme Usage Guide (GSOD-2020): Hello World!

gravatar

by Jacqueline Binya on 2020-09-30

This blog is part of the series: GSOD-2020: WordPress Base Theme Usage Guide

My name is Jacqueline Binya. I am a software developer and technical writer from Zimbabwe. I am going to write a series of blog posts documenting my experience and lessons as I contribute to the Creative Commons WordPress Base Theme(CC WP Base Theme) during the Google Season of Docs (GSOD-2020) as a technical writer.

What is Google Season of Docs?

The Google Season of the Docs was born out of a need to improve the quality of open-source documentation as well as to advocate for open source, for documentation, and for technical writing. Annually during the GSOD, technical writers are invited to contribute to open-source projects through a highly intensive process geared at ensuring that the technical writers and the projects they contribute to during GSOD are a good fit, after that has been determined GSOD then resumes.

Building the docs

The CC WP Base theme is a WordPress theme used to create front-facing Creative Commons (CC) websites. My task is to collaborate with the engineering team to create community facing docs for the theme.

Guiding principles

The docs should be inclusive meaning: they should be written in an easy-to-understand manner taking care to avoid the use of excessive technical jargon, they should be accessible and they should have support for internationalization. We hope to provide our users with a smooth and memorable experience whilst using the docs hence the docs site should be fast and easy to navigate.

Technical stack of the project

We decided to build the docs using Jamstack, to be specific we are using Gridsome a static generator for Vuejs. We are using Gridsome as it is highly performant, and it also integrates smoothly with the CC Vocabulary. Gridsome also has out-of-the-box support for important features like Google Analytics and Angolia, these features will obviously be useful in future iterations of the docs. To quickly scaffold the docs we used a Gridsome theme called JamDocs.

Progress

Currently, the project is on track. As it's been stated we are creating the docs collaboratively. The very first step in our workflow is to create draft content using Google docs. That task is assigned to me, it involves doing lots of research, reading and also testing out the theme. Afterwards, my mentors Hugo Solar and Timid Robot Zehta then give me feedback on the draft. Then I implement the feedback and continuously work on improvements. The final step is migrating the approved draft content to the docs projects in markdown format.

My lessons so far:

Thank you for reading, watch out for the next update which will be posted soon.