This repo provides the source material for City of Chicago's Open311 application programmer interface (API). The documentation in the master branch is compiled and deployed to the city's developer's site.

This repository should only be used to edit the source documents for the Open311 documentation. Other changes to dev.cityofchicago.org should be made to that project's repo.

The documentation is compiled with MkDocs and is required while testing.

Test changes to the documentation by opening a terminal and run

mkdocs serve

Visit localhost:8000 in a browser to inspect the documentation.

Once changes are acceptable, build the documentation by returning to the terminal and run

mkdocs build

Commit and push changes to the server.

Currently, the website must be manually deployed to the Amazon S3 instance hosting dev.cityofchicago.org. Copy the contents of the site/ directory from the open311-api-docs repo to s:https://cityofchicago.org/docs/open311/. Using the AWS CLI, this can be done by the following:

cd /path/to/open311-api-docs/site
aws s3 cp . s3:https://dev.cityofchicago.org/docs/open311 --recursive

Please note: the site/ directory is not tracked by git and not commited to the repo. While it is feasible to automatically deploy the documentation to the final website, there is an issue preventing it. See #2 for a description of that issue.

Copyright © 2016-2017 City of Chicago. Documentation is licensed under Creative Commons Attribution-ShareAlike 4.0 International.