Skip to content

Commit 64c2de1

Browse files
authored
Merge branch 'master' into master
2 parents 149418c + 92cb848 commit 64c2de1

File tree

6 files changed

+60
-27
lines changed

6 files changed

+60
-27
lines changed
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.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
name: cc-wp-base-theme
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._
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
name: GSOD-2020: WordPress Base Theme Usage Guide

databags/issues.json

+9-26
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": 1601000098,
16+
"updatedAt": 1601507650,
1717
"url": "https://github.com/creativecommons/cccatalog/issues/423"
1818
},
1919
{
@@ -302,20 +302,21 @@
302302
"number": 274,
303303
"repo": "cccatalog",
304304
"title": "[API Integration] Walters Art Museum",
305-
"updatedAt": 1601000303,
305+
"updatedAt": 1601489296,
306306
"url": "https://github.com/creativecommons/cccatalog/issues/274"
307307
},
308308
{
309309
"createdAt": 1579719318,
310310
"labels": [
311311
"Hacktoberfest",
312312
"help wanted",
313-
"\u2728 goal: improvement"
313+
"\u2728 goal: improvement",
314+
"\ud83d\udcac talk: discussion"
314315
],
315316
"number": 159,
316317
"repo": "creativecommons.github.io-source",
317318
"title": "Move information about old GSoC projects to CC Open Source ",
318-
"updatedAt": 1601345355,
319+
"updatedAt": 1601490653,
319320
"url": "https://github.com/creativecommons/creativecommons.github.io-source/issues/159"
320321
},
321322
{
@@ -574,7 +575,7 @@
574575
"number": 33,
575576
"repo": "licensebuttons",
576577
"title": "Deduplicate `/www/l`",
577-
"updatedAt": 1601076506,
578+
"updatedAt": 1601553699,
578579
"url": "https://github.com/creativecommons/licensebuttons/issues/33"
579580
},
580581
{
@@ -757,7 +758,7 @@
757758
"number": 63,
758759
"repo": "ccos-scripts",
759760
"title": "Improvements to logging",
760-
"updatedAt": 1600999338,
761+
"updatedAt": 1601413927,
761762
"url": "https://github.com/creativecommons/ccos-scripts/issues/63"
762763
},
763764
{
@@ -772,7 +773,7 @@
772773
"number": 60,
773774
"repo": "ccos-scripts",
774775
"title": "Code organisation can be improved",
775-
"updatedAt": 1601277002,
776+
"updatedAt": 1601542673,
776777
"url": "https://github.com/creativecommons/ccos-scripts/issues/60"
777778
},
778779
{
@@ -923,24 +924,6 @@
923924
"updatedAt": 1601054405,
924925
"url": "https://github.com/creativecommons/creativecommons.github.io-source/issues/518"
925926
},
926-
{
927-
"createdAt": 1601052880,
928-
"labels": [
929-
"Hacktoberfest",
930-
"good first issue",
931-
"help wanted",
932-
"\u2728 goal: improvement",
933-
"\ud83c\udfc1 status: ready for work",
934-
"\ud83d\udd79 aspect: interface",
935-
"\ud83d\udee0 goal: fix",
936-
"\ud83d\udfe9 priority: low"
937-
],
938-
"number": 517,
939-
"repo": "creativecommons.github.io-source",
940-
"title": "Use ISO-8601 date format on the issue finder",
941-
"updatedAt": 1601201885,
942-
"url": "https://github.com/creativecommons/creativecommons.github.io-source/issues/517"
943-
},
944927
{
945928
"createdAt": 1601046285,
946929
"labels": [
@@ -972,7 +955,7 @@
972955
"number": 39,
973956
"repo": "cc-licenses",
974957
"title": "The repository does not contain a CC metadata file",
975-
"updatedAt": 1601047583,
958+
"updatedAt": 1601465171,
976959
"url": "https://github.com/creativecommons/cc-licenses/issues/39"
977960
},
978961
{

webpack/js/components.js

+2-1
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,8 @@ export const IssueCard = {
7171
computed: {
7272
dateCreated() {
7373
const dateCreated = new Date(this.issue.createdAt * 1000)
74-
return dateCreated.toLocaleDateString()
74+
const [dateComponent,] = dateCreated.toISOString().split("T")
75+
return dateComponent
7576
}
7677
}
7778
}

0 commit comments

Comments
 (0)