|
| 1 | +# THIS IS WORK IN PROGRESS :) |
| 2 | + |
| 3 | +# Welcome to Hoodie Camp! |
| 4 | + |
| 5 | +The Hoodie Camp is a space we created to welcome new and existing contributors. |
| 6 | +We work together on code, design, documentation and editorial, with the common |
| 7 | +goal to empower as many people as possible to express themselves with technology. |
| 8 | + |
| 9 | +All teams create special starter issues for people who want to contribute to |
| 10 | +Hoodie for the first time, and especially welcome people who never contributed |
| 11 | +to an Open Source Project before. We try to have issues for both beginners as |
| 12 | +well as challenges for more experienced contributors. |
| 13 | + |
| 14 | +> You don't build a community. You build a space. |
| 15 | +> – [@saronyitbarek](https://twitter.com/kwugirl/status/728370365957689344) |
| 16 | +
|
| 17 | + |
| 18 | + |
| 19 | +## Hoodie Camp site |
| 20 | + |
| 21 | +_this is work in progress_ |
| 22 | + |
| 23 | +We want to create a website for new and existing contributors with three main |
| 24 | +sections: |
| 25 | + |
| 26 | +- Contribute |
| 27 | + Show open issues to new contributors, returning contributors, |
| 28 | + pull requests that need reviews, issues that are work in progress but have |
| 29 | + no update since over a week, etc. |
| 30 | +- Roadmap & News |
| 31 | + Show our overall master plan (Camp / Village / City) release, what parts we |
| 32 | + currently work on, and show a log of what happened lately. |
| 33 | +- Help |
| 34 | + Documentation for contributors and maintainers, e.g. how to start a pull |
| 35 | + request, how to rebase / squash commits, how to create a new |
| 36 | + contributor-friendly issues, what are starter issues, etc etc etc |
| 37 | + |
| 38 | +The idea is to have a static website which loads data directly trough the |
| 39 | +GitHub API, similar to [Ubersicht](http://espy.github.io/ubersicht/#hoodiehq) |
| 40 | +for issues and [Milestones](http://gr2m.github.io/milestones/) for the roadmap. |
| 41 | + |
| 42 | +The Contribute page would have more of a dashboard character. For example, the visitor |
| 43 | +can switch between a "Your First PR" mode showing issues prepared for new |
| 44 | +contributors or showing non-YFPR issues, or showing issues with a "simple" |
| 45 | +label for people that are beginners or don’t have much time or with a label |
| 46 | +"challenge" for harder issues. The visitor can also switch between seeing all |
| 47 | +issues or only from one of the teams (code, design, documentation, editorial). |
| 48 | + |
| 49 | +The visitor can switch to a "maintainer" mode, which would show all issues that |
| 50 | +people are working on, highlighting the ones that have no recent updates and |
| 51 | +the ones that are ready for a review (`LGTM`). |
| 52 | + |
| 53 | +The goal is not to move all issues from the project to the camp repository, only |
| 54 | +the ones prepared for first-time contributors and the ones that are well prepared. |
| 55 | + |
| 56 | +The roadmap section will show something like (or exactly like) [Milestones](http://gr2m.github.io/milestones/). |
| 57 | +These are based on high-level issues that usually consist of bullet items that |
| 58 | +reference other issues (from camp repository or one of the others). |
| 59 | + |
| 60 | +The Help section can load content directly from the repository’s wiki. Or not. |
| 61 | +What ever makes sense :) |
0 commit comments