Merge branch 'master' into open-graph-image-generation

Author: zackkrida

content/blog/entries/cc-wp-base-theme-docs-content-creation/contents.lr

@@ -0,0 +1,59 @@
+title: Content Creation Phase: WordPress Base Theme Usage Guide
+---
+categories:
+cc-wp-base-theme
+gsod
+gsod-2020
+---
+author: JackieBinya
+---
+series: gsod-2020-wordpress-base-theme-usage-guide
+---
+pub_date: 2020-11-10
+---
+body:
+For the past couple of weeks we have been actively creating content for the Creative Commons WordPress Base Theme Usage Guide. Currently the draft content is under final review before it is migrated to the main docs site.
+
+## Our Strategy
+Our main goal in creating the docs is to create rich, intuitive, engaging, and beautifully presented community facing documentation for the Creative Commons WordPress Base Theme. 
+
+In alignment with the defined goal, our core focus is to create the docs collaboratively.
+
+The CC WordPress team consists of I, Jacqueline Binya, Hugo Solar and Timid Robot Zehta. Although our team is small it is quite diverse. It consists of a diverse mix of technical skills: I am a junior developer whereas Hugo and Timid are way senior. We also have non-native and native English speakers.
+
+Diversity is important as we hope to create a high quality product that caters for everyone.
+
+My role as the tech writer/frontend developer is to create the content: write the documentation, build the docs site and also to create all illustrative media.
+
+During the content creation phase, the first step involved creating the skeleton of the actual docs site. We created a git branch called _docs_ within the [creative-commons/wp-base-theme](https://github.com/creativecommons/wp-theme-base) repository. All content related to the documentation is persisted in that branch. So,please feel free to contribute. We then used [JamDocs](https://gridsome.org/starters/jamdocs/), a [Gridsome](https://gridsome.org/) theme to quickly scaffold the site. We had to adapt the theme so as to make it meet our own specific needs, this involved overhauling the styles and changing the functionality of some of the features in the theme. After that was completed, we then created a [Google Doc](https://docs.google.com/document/d/1yfAQGG70T8BUhZYWglAlQ_lTo4_tYpyjhPN5FsZnSvI/edit?usp=sharing) we use for collaboratively writing the draft content for the docs site.
+
+## Tech Stack
+As it was mentioned we used [Gridsome](https://gridsome.org/) a static generator for [Vuejs](https://vuejs.org/). We chose Gridsome because:
+
+- We wanted to lower the barrier of entry to contributing:
+    - Gridsome/Vuejs community is very active, help is but a click away.
+    - The Gridsome official documentation is very resourceful and well maintained.
+
+- Gridsome is highly flexible: The content for the actual documentation is written in [Markdown](https://www.markdownguide.org/getting-started/) but using [@gridsome/vue-remark](https://gridsome.org/plugins/@gridsome/vue-remark), which is a Gridsome plugin, we are able to use javascript in Markdown. We intend to include a copy to the clipboard Vuejs component in the site.
+
+- Time Constraint: This project is a short running project which has to be completed in a 3 month period. Through the use of JamDocs, a Gridsome templating theme as well various plugins it was easy and fast to get started we were able to add more functionality to the theme with minimal effort.
+
+- Ease of integrating [CC Vocabulary](https://cc-vocabulary.netlify.app/) with Gridsome: it is a requirement that the general aesthetics of all front facing Creative Commons applications is derived from the CC Vocabulary Design System. Major cons for using a design system include the ensuring uniformity in design for all front facing CC products.
+
+## Tools Used
+- [Figma](https://www.figma.com/):
+
+![An example of illustrative media](image.png)
+
+Figma was used to make assets(banners, logos and illustrations) in the theme. The illustrative media was created with accessibility in mind and all the topography used in the illustrative assets was derived from the CC Vocabulary.
+
+- [VokoScreenNG](https://linuxecke.volkoh.de/vokoscreen/vokoscreen.html): an open source screencast recording tool used to record all the screen cast demos available in the docs site.
+
+- [ShortCut](https://shotcut.org/): an open source video editing tool.
+
+## What comes next ?
+
+After the final review is completed and all feedback implemented we will migrate all the content to the main docs site. 
+
+_Stay tuned for an update about the launch of the CC WP Base Theme Docs site._
+

content/blog/entries/cc-wp-base-theme-docs-content-creation/image.png

@@ -11,7 +11,7 @@
             "number": 583,
             "repo": "cccatalog-api",
             "title": "Invalidate filter cache after updates to content provider table",
-            "updatedAt": 1601086515,
+            "updatedAt": 1605381784,
             "url": "https://github.com/creativecommons/cccatalog-api/issues/583"
         },
         {
@@ -400,7 +400,7 @@
             "number": 967,
             "repo": "creativecommons.org",
             "title": "Missing Full name of the license on the \"choose\" page",
-            "updatedAt": 1604170862,
+            "updatedAt": 1605123321,
             "url": "https://github.com/creativecommons/creativecommons.org/issues/967"
         },
         {
@@ -446,37 +446,6 @@
             "updatedAt": 1604609253,
             "url": "https://github.com/creativecommons/creativecommons.github.io-source/issues/553"
         },
-        {
-            "createdAt": 1604537824,
-            "labels": [
-                "good first issue",
-                "help wanted",
-                "\ud83c\udf1f goal: addition",
-                "\ud83d\udd79 aspect: interface",
-                "\ud83d\udfe7 priority: high"
-            ],
-            "number": 763,
-            "repo": "vocabulary",
-            "title": "Component: Radio Button",
-            "updatedAt": 1604537824,
-            "url": "https://github.com/creativecommons/vocabulary/issues/763"
-        },
-        {
-            "createdAt": 1604498467,
-            "labels": [
-                "good first issue",
-                "help wanted",
-                "\u2728 goal: improvement",
-                "\ud83c\udfc1 status: ready for work",
-                "\ud83d\udcbb aspect: code",
-                "\ud83d\udfe7 priority: high"
-            ],
-            "number": 97,
-            "repo": "ccos-scripts",
-            "title": "Remove Hacktoberfest labels",
-            "updatedAt": 1604500087,
-            "url": "https://github.com/creativecommons/ccos-scripts/issues/97"
-        },
         {
             "createdAt": 1603813791,
             "labels": [
@@ -507,7 +476,7 @@
             "number": 545,
             "repo": "creativecommons.github.io-source",
             "title": "The header is not accessible by keyboard completely.",
-            "updatedAt": 1604042628,
+            "updatedAt": 1605043493,
             "url": "https://github.com/creativecommons/creativecommons.github.io-source/issues/545"
         },
         {
@@ -585,7 +554,7 @@
             "number": 292,
             "repo": "ccsearch-browser-extension",
             "title": "Add license explanation tool tip in the filter section",
-            "updatedAt": 1604067460,
+            "updatedAt": 1604630934,
             "url": "https://github.com/creativecommons/ccsearch-browser-extension/issues/292"
         },
         {
@@ -691,23 +660,6 @@
             "updatedAt": 1601038933,
             "url": "https://github.com/creativecommons/licensebuttons/issues/32"
         },
-        {
-            "createdAt": 1599539123,
-            "labels": [
-                "help wanted",
-                "\ud83c\udf1f goal: addition",
-                "\ud83c\udfc1 status: ready for work",
-                "\ud83d\udcaa skill: javascript/vue",
-                "\ud83d\udcbb aspect: code",
-                "\ud83d\udd79 aspect: interface",
-                "\ud83e\udd16 aspect: dx"
-            ],
-            "number": 642,
-            "repo": "vocabulary",
-            "title": "[Vue] Header Component and general component style discussion",
-            "updatedAt": 1601916544,
-            "url": "https://github.com/creativecommons/vocabulary/issues/642"
-        },
         {
             "createdAt": 1598845438,
             "labels": [
@@ -725,21 +677,6 @@
             "updatedAt": 1602683499,
             "url": "https://github.com/creativecommons/cccatalog/issues/492"
         },
-        {
-            "createdAt": 1598462581,
-            "labels": [
-                "Hacktoberfest",
-                "help wanted",
-                "\u2728 goal: improvement",
-                "\ud83d\udd79 aspect: interface",
-                "\ud83d\udfe7 priority: high"
-            ],
-            "number": 620,
-            "repo": "vocabulary",
-            "title": "Update the header component",
-            "updatedAt": 1602328010,
-            "url": "https://github.com/creativecommons/vocabulary/issues/620"
-        },
         {
             "createdAt": 1598461505,
             "labels": [