Skip to content

Latest commit

 

History

History
81 lines (63 loc) · 4.15 KB

README.md

File metadata and controls

81 lines (63 loc) · 4.15 KB
Raw

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",
    "tags": [
      "Brigade",
      "Official"
    ],
    "social_profiles": {
        "twitter": "@BetaNYC",
        "facebook": "https://www.facebook.com/BetaNYC/"
    }
}
  • 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 and longitude 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.
  • tags is an array of descriptors for your group. The most commonly used tags are:
    • Brigade
    • Official
    • Code for All - CodeForAll.org network member
    • Code for All Affiliate - Code for All network affiliate member
    • Fellowship - organization is running a fellowship program
    • Government
  • type (DEPRECATED) is a list of tags, comma separated. Use tags instead.
  • social_profiles is an object with the keys being the name of the social network and the value being the identifying address on that network. Specifically,
    • twitter - The Twitter handle including @.
    • facebook - The Facebook Page URL

Before committing your change, please make sure that there are no formatting issues by running the bin/format-json script. (You will need to brew install jq moreutils for that script to run.)

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.