|
| 1 | +title: Vocabulary Site & Usage Guide Introduction (GSoD'20) |
| 2 | +--- |
| 3 | +categories: |
| 4 | +cc-vocabulary |
| 5 | +gsod |
| 6 | +gsod-2020 |
| 7 | +--- |
| 8 | +author: nimishbongale |
| 9 | +--- |
| 10 | +series: gsod-2020-vocabulary-usage-guide |
| 11 | +--- |
| 12 | +pub_date: 2020-10-02 |
| 13 | +--- |
| 14 | +body: |
| 15 | +Hey there! I'm Nimish Bongale, a Technical Writer & Software Developer based out of Bangalore, India. My other hobbies include playing chess and the guitar. I look forward to build the CC Vocabulary site and usage guides as a part of GSoD'20. |
| 16 | + |
| 17 | +## But what is GSoD? |
| 18 | + |
| 19 | +GSoD, or Google Season of Docs, is a program that stresses on the importance of the documentation aspect of Open Source projects. It invites technical writers from across the world to submit proposals based on projects floated in by the participating Open Source Organisations. The selected technical writers then work with the their respective organisations and look to complete their work by the end of their internship period. More information about the same can be found [here](https://developers.google.com/season-of-docs). |
| 20 | + |
| 21 | +Let's talk a bit about my project, shall we? |
| 22 | + |
| 23 | +## Vocabulary Site & Usage Guide |
| 24 | + |
| 25 | +### Introduction |
| 26 | +[CC Vocabulary](https://github.com/creativecommons/vocabulary) is a cohesive design system & Vue component library to unify the web-facing Creative Commons. It's currently comprised of 3 packages, namely Vocabulary, Vue-Vocabulary & Fonts. My contribution to this project would majorly involve building the landing site for CC Vocabulary, and refactor the documentation wherever necessary. |
| 27 | + |
| 28 | +### What drives me |
| 29 | +Documentation is one of the primary reasons which determines how successful a certain open source library will be. The major question that developers think of while choosing a suitable tech stack to build their applications is: |
| 30 | + |
| 31 | +- Is the library _well documented_? |
| 32 | +- Is it _well maintained_? |
| 33 | +- Does it have some _considerable usage and error support_? |
| 34 | + |
| 35 | +These are exactly the questions I should be asking myself while going about this project idea. |
| 36 | + |
| 37 | +As aforementioned, there is an immanent need to have a concise and consolidated documentation. The lack of documentation hurts the future perspectives of open source applications, and is by far, an essential and non-negligible component. Linking to these documentations should be an appealing home page, which captures the interest of the people in an instant. The documentation should be well organised, thereby enabling a seamless flow through it. |
| 38 | + |
| 39 | +### Tech stack of the project |
| 40 | +We have decided to move forward with [Vuejs](https://vuejs.org/) for building the site, and continue work on the existing [storybooks](https://storybook.js.org/) of Vocabulary, Vue-Vocabulary and Fonts. Storybookjs has had some great improvements in recent times, and the new addons that are offered will greatly support my work. Besides these, I will also be using [StackEdit](https://stackedit.io/) to write and share Markdown files of my writings. |
| 41 | + |
| 42 | +### Progress - Baby Steps |
| 43 | +I have contributed to CC in the past. It would now be my first time contributing to a specific project within CC, while being a member of CC Open Source. Some tasks that I've been able to initiate/accomplish so far: |
| 44 | + |
| 45 | +- Look at Open Source documentation conventions, and see if we violate any. |
| 46 | +- Understand the level of existing documentation currently present in our storybooks. |
| 47 | +- Discuss about the Monorepo migration and help out with the implementation. |
| 48 | +- Migrate `storybookjs` to the latest version. |
| 49 | +- Implement `addon-controls` for vocabulary. |
| 50 | +- Design the vocabulary site. |
| 51 | +- Promote the involvement of CC Open Source in [Hacktoberfest](https://hacktoberfest.digitalocean.com/) 2020. |
| 52 | + |
| 53 | +### What did I learn? |
| 54 | + |
| 55 | +- Design is more than just picking colors and placing components on a grey screen. |
| 56 | +- It's important to read your own writings from an unbiased perspective to actually understand how well it would be perceived. |
| 57 | +- Interacting with your mentor on a regular basis is of the absolute essence. |
| 58 | +- Publishing to [npmjs](npmjs.com) is not difficult! |
| 59 | + |
| 60 | +<p align="center"> |
| 61 | + <strong>Thank you for your time!</strong> |
| 62 | +</p> |
0 commit comments