/beyondtransparency

Code for America's new book - Beyond Transparency :closed_book:

Primary LanguageHTMLOtherNOASSERTION

Beyond Transparency

Code for America's new đź“• - Beyond Transparency

About this Book

This book is a resource for (and by) practitioners inside and outside government—from the municipal chief information officer to the community organizer to the civic-minded entrepreneur. Beyond Transparency is intended to capture and distill the community's learnings around open data for the past four years. And we know that the community is going to continue learning. That's why, in addition to the print version of the book which you can order on Amazon, we've also published the digital version of this book on this site under a Creative Commons license. The full text of this site is on GitHub — which means that anyone can submit a pull request with a suggested edit. Help us improve this resource for the community and write the next edition of Beyond Transparency by submitting your pull requests.

Code for America is a national nonprofit committed to building a government for the people, by the people, that works in the 21st century. Over the past four years, CfA has worked with dozens of cities to support civic innovation through open data. You can support this work by contributing to the book on GitHub, joining the CfA volunteer community (the Brigade), or connecting your city with CfA.

Contributing

The easiest way to suggest changes is to make edits directly on GitHub. If you're a web developer, you can clone the website to your computer and make changes using your preferred tools.

Editing directly on github.com

  1. Create a GitHub account if you don't already have one, and sign in
  2. Click on chapters
  3. Click on the chapter you want to edit
  4. Click on the "Edit" button
  5. Make your changes using the Markdown format
  6. Click on the "Preview" button to make sure your changes look good
  7. Type in your Commit summary (i.e. a brief description of your changes) at the bottom of the GitHub edit page, and an optional extended description
  8. Click "Propose File Change"

Cloning and running on your local machine

git clone https://github.com/codeforamerica/beyondtransparency.git
cd beyondtransparency
gem install jekyll
gem install rdiscount
jekyll serve --watch

You can now view the website at http://localhost:4000

View the Jekyll documentation for more details about the site structure.

Submitting a Pull Request from your local machine

  1. Create a topic branch.
  2. Make your changes.
  3. Add, commit, and push your changes.
  4. Submit a pull request.

LICENSE

The content of this project itself is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported license, and the underlying source code used to format and display that content is licensed under the MIT license.