Contributing to Project Interoperability

By contributing to this project, you dedicate your work to the public domain and relinquish any copyright claims under the terms of the CC0 Public Domain Dedication. See the license file for additional information.

How to Contribute

This project constitutes a collaborative work (“open source”). Federal employees and members of the public are encouraged to improve the project by contributing. For more information, please see the FAQ

Contributions can be made, primarily, in two ways:

Easy

  1. Click the “Help Improve this Content” button in the top right corner of any page.
  2. Make changes as you would normally.
  3. Click “Propose file change.”
  4. You change should appear once approved.

Note: You may need to create a free GitHub account if you do not already have one

Advanced

  1. Configure git by using this basic tutorial or by downloading the GitHub for Mac (or GitHub for Windows) and optionally Mou.
  2. Fork the project.
  3. Make changes as you would normally using the tools installed in step #1.
  4. Push the changes back to your fork.
  5. Submitting a pull request to this repository
  6. You change should appear once approved.

Running Locally

Project Interoperability runs on GitHub pages and automatically regenerates as a static site after every change. To duplicate this process and preview changes locally:

  1. git clone https://github.com/project-interoperability/project-interoperability.github.io.git && cd project-interoperability.github.io
  2. script/bootstrap
  3. (Make your changes)
  4. script/server
  5. Open localhost:4000 in your favorite web browser

Note: You’ll need Ruby and the Bundler package manager.

Privacy

All comments, messages, pull requests, and other submissions may be subject to archiving requirements. See the readme for more information.