U.S. Department of the Interior Natural Resource Revenue Data
This is the repository for active development work on revenuedata.doi.gov. See releases for information about the current version of the site.
For more detailed process, development, and data information, please see our repository's wiki.
What
The U.S. earns revenue on natural resources (such as oil, gas, coal and geothermal(s) extracted from federal lands and waters. This is a major source of revenue for both the federal government, state governments, and local municipalities.
This repository contains the code for revenuedata.doi.gov, which is a website that includes both curated content and raw data to better inform the national and international conversation around extractive industries revenue. It will provide data visualizations and information that’s understandable to members of the public and can be re-used through other media and applications.
For more information about the history of the site, see about this site.
Contributing
Content and feature suggestions are welcome via GitHub Issues. Code contributions are welcome via pull request, although of course we cannot guarantee your changes will be included in the site.
Public domain
This project is in the worldwide public domain. As stated in CONTRIBUTING:
This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.
Development Notes
Testing
For testing our website we use the following libraries and frameworks:
- ESLint: Code syntax and formatting
- Jest: Javascript Testing Framework
- react-testing-library: Integration, Unit testing
- puppeteer: End to End testing
- lighthouse: Performance and Accessibility testing
The goal is to have 100% test coverage to support our Test Driven Development (TDD), continuous integration and ensure quality code delivery and user experience.
We use CircleCI to run our tests when a change is committed to our code base. Of course all tests can be run from the development environment.