How can we contribute?
Types of Contributions
There are many ways to contribute but three key ones are:
Suggest Content
- Have you had questions that you wished you had answers to? Are there resources or references that you wish were made available to you in a central location? Submit them!
Author Content
- See a question that you can answer or are an expert on? Answer it!
- See an answer that you can improve, build upon, or provide an alternative perspective to? Edit it!
- See ways to organize content better, improve the writing style for clarity or simply make the reading experience easier? Improve it!
Review Content
- Have feedback on the accuracy, clarity or relevance of existing content? Flag it and tell us what you think.
The Contribution Process
The original How to contribute section is referenced here for historical reasons only. Going forward, we propose to handle all contributions via GitHub as follows.
Want to edit content along these lines? All you need is a GitHub account.
- Visit the GDG Wisdom GitBook and click "Edit This Page" on the corresponding page that you want to modify.
- You will be asked to log into your GitHub account to make edits.
- Commit the edits. (This will trigger a pull request to our repository)
- You're done. You will automatically be listed in our GDG Wisdom contributors Dashboard.
You can find a viualisation of the process here.
Contribution Conversations
Have questions or comments? Want to propose new topics? Simply hop into our Gitter chatroom and talk to us, or you can connect to us on GitHub (post an Issue) or G+ (post a message). Join the GDG Wisdom GitHub Organization and then hop into the Gitter chat room below.
Yearly Editions
Every year a new edition is started to keep the wisdom alive.
The following steps needs to be done to create a new edition for year YYYY:
- A label "final-YYYY" to the last commit of the previous year
- Create a new github repository gdg-wisdom/wisdom-YYYY
- Push your local master branch to this new remote repository
- Create a new gitbook gdg-wisdom/gdg-wisdom-YYYY and copy the decription
- Add the github repository as resource
- Add the gitbook webhook to the github repository
- Search and replace in the github repository all occurences of wisdom-YYYY for the previous year
- Create a new gitter chat room for the new github repository
- Update the subdomain wisdom.gdgroups.org to point to the new gitbook content