Skip to content

Latest commit

 

History

History
57 lines (40 loc) · 5.63 KB

onboarding-guide.md

File metadata and controls

57 lines (40 loc) · 5.63 KB

Onboarding Guide: Civic Hacking and You!

Hello! Welcome to Open Wichita. We are the local Code for America brigade for Wichita, KS. Our mission is to foster a community of civic involvement through technology and education. We want to help citizen, government, and nonprofit stakeholders solve problems. Open Wichita is committed to providing a welcoming and inclusive environment for all, read the Code for America Code of Conduct for more information.

Quick reference

💬 We chat and organize on Slack.
:octocat: We plan, coordinate, and work on projects on Github.
📆 Our in-person and virtual meetups are on Meetup.
👍 We also post in-person events on Facebook.
🐦 We post updates and news on Twitter.
:shipit: Any questions? Contact an Open Wichita Captain!

We're civic hackers!

Civic hacking is the idea that small solutions can cause real impact. It's about understanding an issue, creating something to help the problem, see the impact it creates, and adapting based on the information.

Government can move slowly, sometimes VERY slowly. The other issue is government (especially local gov) is strapped for resources. They have a massive job and they can't always do it all themselves. There is a huge opportunity for any person in the area to contribute some time and energy to making things better.

We aim to be the antithesis of how government traditionally operates.

We do this by:

  • Focusing on small scope projects targeting something specific.
  • Rapidly prototyping and deploying projects, then iterating.
  • Prioritizing the use and production of Open Source Software in all we do.
  • Inviting anyone and everyone to express an idea for local impact.
  • Inviting anyone and everyone to pitch in however they can.
  • Our primary function is our project work. Everything we create as a community is open source and hosted on GitHub.

Projects

Our projects are how we engage with the community. Making someone's life a bit better is the goal of every project.

Want to find something to work on?

We have many existing projects. Browse through those to see if there is something you want to help with. Many of the projects have issues and new features that where help is wanted. Check out those help wanted tasks at https://help.openwichita.com/

We also have many existing project ideas. Give a 👍 to vote on ideas you'd like to see. If you want to champion an idea talk to an Open Wichita Captain.

Have an idea for a new project?

If you have an idea for a new project we'd love to hear about it. Please submit your idea and we'll check it out. Let an Open Wichita Captain know if you are willing to "champion" the project. If enough people are willing to work on your idea, we'll help you make it happen.

Github

Have an Open Wichita Captain create the main repo under the Open Wichita organization. You can also migrate existing repos to our organization but this will take some timely coordination on both sides.

Features and bugs

Use the Github issue system to track both features and bugs, using the appropriate tags for both. If you are looking for extra help, be sure to tag issues with the "help wanted" tag. Our Help Wanted tracker will automatically pull those in. The Project Champion should make sure that issues are closed and cleaned up as they should be. Too much noise makes it hard for others to get involved.

License

For a project to be supported by Open Wichita it must have an Open Source license. Specifically, the GNU GPLv3 license. Among other things, this license requires anyone who distributes the code or a derivative work to make the source available under the same terms. In short, we want our projects to help future open source projects.

Technology

We do not require specific programming languages or technology stacks. However, we encourage you to use languages and frameworks that many contributors will be familiar and comfortable with. Keep in mind that if your language or framework is obscure you may not receive much help.

A survey of our contributors found that most people are familiar with Javascript and so we recommend starting projects with Javascript on the front-end and back-end (node.js). For the browser, sticking with simple vanilla Javascript is best. If needed, use a popular framework such as JQuery.

Bootstrap is a fast and simple way to start a web front-end that many people can help with.

While we love CSS preprocessors, we recommend sticking with vanilla CSS to make it easy for people to contribute.

Project Champions

🏆 Learn more about becoming a Project Champion.