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.
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.
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.
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.
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.