Brigade Information
This repository hosts data about Code for America brigades and other civic tech organizations for the Code for America API.
How to add or edit your Brigade for the API
The organization list is a JSON file named organizations.json. Add or edit your organization's information in that file and submit your changes as a pull request.
A single organization's record looks like this:
{
"name": "Beta NYC",
"website": "http://www.beta.nyc",
"events_url": "http://www.meetup.com/BetaNYC/",
"rss": "http://betanyc.tumblr.com/",
"projects_list_url": "http://projects.betanyc.us/projects",
"city": "New York, NY",
"latitude": "40.7144",
"longitude": "-74.0060",
"type": "Brigade, Official"
}
name
- Required - The name of your organization.events_url
is the URL of your event-scheduling page. Only meetup.com URLs are supported.rss
is the URL of a blog or its RSS feed. The API will look in the usual places for a feed URL if the link isn't direct. Non-blog RSS feeds will also be processed.projects_list_url
is the URL of a GitHub organization or of a list of project URLs, formatted as described below.latitude
andlongitude
values can be figured out using a tool like LatLong.net. Required if you want to appear on the Brigade or Code for All maps.type
is the type of organization you're adding – the most commonly used types areBrigade
,Code for All
, andGovernment
.
Projects List
If you don't want to use a GitHub organization URL for your projects list, you can link to a custom CSV or JSON file.
The custom projects list should have the following columns:
name
is the project's name (filled in by GitHub if left blank)description
is the project's description (filled in by GitHub if left blank)link_url
a link to the project's web page (filled in by GitHub if left blank)code_url
a link to the project's repository (only GitHub links are supported)
A CSV example:
name,description,link_url,code_url
South Bend Voices,"A redeploy of CityVoice for South Bend, IN.",http://www.southbendvoices.com/,https://github.com/codeforamerica/cityvoice
The projects list URL can be any flavor of csv. The easiest way is to make a Google Spreadsheet like my example and then select File > Publish it to the web.
If you are using the new Google Spreadsheets, add /export?format=csv
to the end.
https://docs.google.com/spreadsheets/d/<key>/export?format=csv
If you have the older Google Drive version change ?output=html
to ?output=csv
.
https://docs.google.com/spreadsheet/pub?key=<key>?output=csv
Put that in the Brigade Information sheet and you're done.
The projects list URL can also be a JSON file, with a list of strings containing GitHub project URLs.
If you have any questions, start an issue on this repo.