Merge branch 'master' into srinidhi_gsoc_final_blog

Author: kgodey

.gitignore

@@ -13,3 +13,4 @@ node_modules
 gui/build
 gui/node_modules
 gui/static/gen
+*.log

README.md

@@ -47,23 +47,32 @@ via lektor (see [Deployment](#deployment), below).
 
 ### Pre-Requisites
 
-Make sure you have [pipenv][pipenvdocs], [Node.js][nodejswebsite] and [npm][npmdocs] installed. To install these, execute the following commands:
+Make sure you have:
+
+* [pipenv][pipenvdocs]
+
+* [Node.js][nodejswebsite] **v12+** and [npm][npmdocs] installed. 
+
+To install these, execute the following commands:
 
 > For  macOS:
+
 1. `brew install pipenv`
 2. `brew install node`
 
 > For GNU/Linux:
+
 1. `curl https://raw.githubusercontent.com/kennethreitz/pipenv/master/get-pipenv.py | python`
 2. `sudo apt update`
-3. `sudo apt install nodejs`
+3. [Install Node.js](https://github.com/nodesource/distributions/blob/master/README.md#table-of-contents) 
 4. `sudo apt install npm `
 
 [pipenvdocs]:https://pipenv.readthedocs.io/en/latest/
 [nodejswebsite]:https://nodejs.org/en/
 [npmdocs]:https://docs.npmjs.com/ 
 
 
+
 ### Installing Project Requirements
 
 1. Clone this repository.
@@ -91,6 +100,20 @@ else fails, try removing the virtual environment and reinstalling:
 
 [local5000]:http://localhost:5000/
 
+### Troubleshooting Possible Errors
+
+* Should you get series of type errors that looks something like `npm ERR! typeerror Error: Missing required argument #1`, after running `pipenv run lektor server -f webpack`, this is most likely due to running an older version of Node.js.
+
+  As stated earlier in the prerequisites, you should be running Node.js version 12+.
+  Follow [this](https://github.com/nodesource/distributions/blob/master/README.md#table-of-contents) tutorial to upgrade your node version (for GNU/Unix systems).
+
+* Should you get an `OSError: [Errno 28] inotify watch limit reached` after running any command, this means that your system file watcher is running out of alloted handles, usually because the workspace is large and contains many files. 
+
+  The solution is to run:
+`sudo sysctl fs.inotify.max_user_watches=524288`
+
+  This increases your `inotify` watch limit (for the session) to 524288, which is the maximum value and is also enough to allow the  setup go through.
+  You can learn more about file watchers [from this blog post](https://unixia.wordpress.com/2018/04/28/inotify-watch-limit-reached-wait-what/) or [from the VS Code documentation](https://code.visualstudio.com/docs/setup/linux#_visual-studio-code-is-unable-to-watch-for-file-changes-in-this-large-workspace-error-enospc).
 
 ## Deployment
 

content/blog/authors/aldenpage/contents.lr

@@ -2,5 +2,7 @@ username: aldenpage
 ---
 name: Alden Page
 ---
+md5_hashed_email: 32853a2ab283e0093bf088d8af5d3cdc
+---
 about:
 [Alden](https://creativecommons.org/author/aldencreativecommons-org/) is Backend Software Engineer at Creative Commons. He is `@aldenpage` on the CC Slack.

content/blog/authors/annatuma/contents.lr

@@ -0,0 +1,8 @@
+username: annatuma
+---
+name: Anna Tumadóttir
+---
+md5_hashed_email: c6b98be141f57ce877a7ae10595b0ae0
+---
+about:
+[Anna](https://creativecommons.org/author/annacreativecommons-org/) is Director of Product at Creative Commons. She's `@Anna` on the CC Slack.

content/blog/authors/blank_profile.svg

@@ -5,6 +5,5 @@ name: Dhruv Bhanushali
 md5_hashed_email: 0eab64adad056cff2492e7c407a9aa21
 ---
 about:
-Dhruv Bhanushali is a Mumbai-based software developer and an Engineering-Physics graduate from IIT Roorkee. He started programming as a hobby in high-school and having found his calling, is now pursuing a career in the field. He is a huge fan of alternative and post-rock music and keeps his curated collection with him at all times. He also loves to binge watch TV shows and movies, especially indie art films.
 
-Dhruv developed [CC Vocabulary](https://opensource.creativecommons.org/cc-vocabulary/) as part of [Google Summer of Code 2019](/gsoc-2019/) and now is a maintainer for the project. He is consistently [`@dhruvkb`](https://dhruvkb.github.io/) everywhere.
+[Dhruv Bhanushali](https://dhruvkb.github.io/) is the Open Source Community Coordinator at Creative Commons. He goes by `@dhruvkb` on the CC Community Slack workspace. Dhruv developed [CC Vocabulary](https://opensource.creativecommons.org/cc-vocabulary/) as part of [Google Summer of Code 2019](/gsoc-2019/) and now is a maintainer for the project.

content/blog/authors/dhruvkb/contents.lr

@@ -2,7 +2,7 @@ username: kss682
 ---
 name: K S Srinidhi Krishna
 ---
-md5_hashed_email: 7E71C293A442A2CF434BFC244BD5F184
+md5_hashed_email: 7e71c293a442a2cf434bfc244bd5f184
 ---
 about:
 Srinidhi Krishna is a computer science undergraduate student from India and will be interning with Creative Commons during the summer.

content/blog/authors/srinidhi/contents.lr

@@ -0,0 +1 @@
+name: collaboration

content/blog/categories/collaboration/contents.lr

@@ -0,0 +1 @@
+name: gsod-2020

content/blog/categories/gsod-2020/contents.lr

@@ -0,0 +1 @@
+name: gsod