Skip to content

Commit f5f9848

Browse files
authored
Merge branch 'master' into iso-date
2 parents 51e9d69 + 5b26be8 commit f5f9848

File tree

5 files changed

+54
-5
lines changed

5 files changed

+54
-5
lines changed
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
username: JackieBinya
2+
---
3+
name: Jacqueline Binya
4+
---
5+
md5_hashed_email: 05fbbdaf9f9d84074e200f88f662688f
6+
---
7+
about:
8+
[JackieBinya](https://github.com/JackieBinya) is a software developer, technical writer, cloud enthusiast, and a Google Season of Docs 2020 participant.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
name: cc-wp-base-theme
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
title: WordPress Base Theme Usage Guide (GSOD-2020): Hello World!
2+
---
3+
categories:
4+
cc-wp-base-theme
5+
gsod
6+
gsod-2020
7+
---
8+
author: JackieBinya
9+
---
10+
series: gsod-2020-wordpress-base-theme-usage-guide
11+
---
12+
pub_date: 2020-09-30
13+
---
14+
body:
15+
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)](https://github.com/creativecommons/wp-theme-base) during the [Google Season of Docs (GSOD-2020)](https://developers.google.com/season-of-docs) as a technical writer.
16+
17+
## What is Google Season of Docs?
18+
19+
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.
20+
21+
## Building the docs
22+
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.
23+
24+
### Guiding principles
25+
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.
26+
27+
### Technical stack of the project
28+
We decided to build the docs using [Jamstack](https://jamstack.org/), to be specific we are using [Gridsome](https://gridsome.org/) a static generator for [Vuejs](https://vuejs.org/). We are using Gridsome as it is highly performant, and it also integrates smoothly with the [CC Vocabulary](https://cc-vocabulary.netlify.app/). Gridsome also has out-of-the-box support for important features like Google Analytics and [Angolia](https://www.algolia.com/), these features will obviously be useful in future iterations of the docs. To quickly scaffold the docs we used a Gridsome theme called [JamDocs](https://gridsome.org/starters/jamdocs/).
29+
30+
### Progress
31+
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.
32+
33+
### My lessons so far:
34+
- Always ask questions: frankly, the only way you can create good content is when you have a solid understanding of the subject matter.
35+
- It's better to over-communicate than under-communicate especially when working in a remotely, this is especially more important if you encounter blockers whilst executing your work.
36+
- Push that code and open PR quickly and then go ahead and ask for a review don't procrastinate this will ensure fast turnover you get feedback quickly and can work on improvements.
37+
38+
39+
_Thank you for reading, watch out for the next update which will be posted soon._
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
name: GSOD-2020: WordPress Base Theme Usage Guide

databags/issues.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
"number": 423,
1414
"repo": "cccatalog",
1515
"title": "[API Integration] Natural History Museum (UK)",
16-
"updatedAt": 1601410964,
16+
"updatedAt": 1601507650,
1717
"url": "https://github.com/creativecommons/cccatalog/issues/423"
1818
},
1919
{
@@ -302,7 +302,7 @@
302302
"number": 274,
303303
"repo": "cccatalog",
304304
"title": "[API Integration] Walters Art Museum",
305-
"updatedAt": 1601478507,
305+
"updatedAt": 1601489296,
306306
"url": "https://github.com/creativecommons/cccatalog/issues/274"
307307
},
308308
{
@@ -316,7 +316,7 @@
316316
"number": 159,
317317
"repo": "creativecommons.github.io-source",
318318
"title": "Move information about old GSoC projects to CC Open Source ",
319-
"updatedAt": 1601485174,
319+
"updatedAt": 1601490653,
320320
"url": "https://github.com/creativecommons/creativecommons.github.io-source/issues/159"
321321
},
322322
{
@@ -575,7 +575,7 @@
575575
"number": 33,
576576
"repo": "licensebuttons",
577577
"title": "Deduplicate `/www/l`",
578-
"updatedAt": 1601076506,
578+
"updatedAt": 1601553699,
579579
"url": "https://github.com/creativecommons/licensebuttons/issues/33"
580580
},
581581
{
@@ -773,7 +773,7 @@
773773
"number": 60,
774774
"repo": "ccos-scripts",
775775
"title": "Code organisation can be improved",
776-
"updatedAt": 1601450075,
776+
"updatedAt": 1601542673,
777777
"url": "https://github.com/creativecommons/ccos-scripts/issues/60"
778778
},
779779
{

0 commit comments

Comments
 (0)