Skip to content

A field guide to Citizen Labs projects, people, and purpose.

License

Notifications You must be signed in to change notification settings

citizenlabsgr/read-first

Repository files navigation

Mission

Citizen Labs works together with our entire community to promote transparency, better understand problems, and support informed decisions. We apply open data and open source technology, convene civic volunteers, and engage community guideership to create data-driven solutions.

Citizen Movement?

Our volunteer community runs and drives all Citizen Labs projects! We highly encourage all to become involved and contribute. We believe from our neighborhoods to our cities there's always more room for improvement. Whether it's starting a new project or proposing a new tool for the community to use, don't hesitate to just go for it!

Getting Started

  • The story of who we are.
  • We use Slack and GitHub as our primary means of organization and communication. Join us!
  • Check out our active projects, or how you can jump in.
  • If you see a project you are interested in, join the project Slack channel, introduce yourself to the community and the project guide(s).
  • Visit project readme for specific instructions on who to contact or how to get started.
  • Not sure which project you want to join? Introduce yourself in #welcome. Talk to a few project guides, let them know what you are interested in. Project guides can help you determine if a project is a good fit for you. The guides for each project are listed are listed below.
  • Have an idea for a new project? Join #project-ideas to start a discussion on a new project.
  • Looking for a certain type of task in any project? Check the list of issues.
  • Not sure how to get started? Contact @allen, @brandon, or @jacebrowning in the Slack, or check out the #welcome channel, and we'll help you out. Also check out #micro-projects for quick projects that'll help you get you started.
  • Peak your interest with our Open Data Regional Review Portal, where data can be shared. Contact @allen, @brandon, or @jacebrowning in Slack with questions

Starting a New Project

Congratulations! You have a great idea for a project. Here are a couple of things that will help you and others that want to contribute to your project.

Project Roles

You've probably noticed that there are a few people in every active project taking questions, and helping new folks get settled in. Project guides, ambassadors, and maintainers create value by deeply understanding the project and helping volunteers to get the most out of volunteering. You don't need to be super technical, just organized and enthusiastic!

Below are the descriptions of these common roles:

Ping @allen or @brandon in Slack if you're interested in guiding a project.

Storytelling

Our projects tell stories about our communities, our world, and ourselves. We aim to record these stories on our blog. If you'd like to help with this, ping @allen or @brandon in Slack!

Infrastructure and IT administration

We're doing this on a per-project basis. Connect with @jacebrowning to dive in further.

Active projects

Below is a list of some of our projects that are actively seeking help.


Slack: #project-datacensus Project Description: This project will update the City of Grand Rapids' entry in the US City Open Data Census. Grand Rapids is currently ranked 39th, when we first started in 2014 it was ranked 81st in the country.

Project Guides: @allen

Data: Grand Rapids Open Data Portal


Slack: #project-openbudgetgr Project Description: We are developing a way to better understand the budget process for the City of Wyoming. We will borrow much of what we have learned and developed from a similar project with the City of Grand Rapids. The project intends to promote a deeper understanding of the city budget, so that citizens, officials, and other stakeholders can engage in more informed dialogue about how the City of Wyoming currently works and how it should in the future.

Project Guides: @allen

Data: Github


Slack: #project-openbudgetgr Project Description: We are developing a way to better understand the budget process for the City of Grand Rapids. This is the follow-up to the initial 2016 release of openbudgetgr.org. The Open Budget project intends to promotes a deeper understanding of the city budget, so that citizens, officials, and other stakeholders can engage in more informed dialogue about how the City of Grand Rapids currently works and how it should in the future.

Project Guides: @allen

Data: Grand Rapids Open Data Portal


Contribute

If you're looking for a certain type of task (e.g. beginner-friendly, data-viz) to lead you to a project, try checking the links to issue labels below:

  • analysis: Analysis questions, ranging from basic, exploratory questions to more complex questions.
  • beginner-friendly: Good for people new to the project or technology stack used by the project. If you are experienced we encourage you not to claim these issues but instead post in comments offering to mentor a new person.
  • bug: Bug report.
  • data-collection: Data collection task.
  • data-viz: Data visualization task.
  • discussion: Indicates this issue is a public discussion but may not necessarily have a specific task associated to it.
  • documentation: Request for help with documentation.
  • enhancement: Make everything better.
  • first-pr: For first timers only. Issues with this label are meant to be a digestible to help people get up to speed with cloning the repository, making a change and creating a pull request. Please do not claim this issue unless it is your first pull request for this project.
  • sandbox: Issues with this tag are connected to our community sandbox for teaching Github, cloning, making a change and creating a pull request.
  • help wanted: Catch all label soliciting for help.
  • proposal: Propose a project or idea.
  • question: Running into something you want to ask around about! Use a question label.
  • status-blocked: Not ready for development.
  • status-ready: Development task that is fully defined and ready to start.
  • status-in-progress: Someone is actively working on this issue. Please reach out to the person assigned this issue if you would like to contribute.
  • storytelling: Need help crafting a story. Writing assignment.

About

A field guide to Citizen Labs projects, people, and purpose.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •