Resources for open data and enterprise data inventory management.
This site uses Netlify to manage its editorial workflow. Content is added and edited in collections via the Netlify interface, which can be accessed by approved contributors at resources.data.gov/admin. Collections are managed via the config.yml file in pages/admin.
| Environment | Branch | Description |
|---|---|---|
| resources.data.gov | main |
The production instance of r.d.g. |
| resources-staging.data.gov | develop |
A preview site used for ad-hoc development or significant changes requiring partner review. |
| * | feature branches | Feature branches to preview a single change. |
Federalist builds all branches and creates previews for them. Two branches are
special, main which is automatically deployed by Federalist to
resources.data.gov and develop which is used as
a staging branch for significant changes.
Deploying to staging is not required. It might be useful for previewing significant changes to the site that require partner review.
- Ruby 2.6
- Bundler 1.17.x (we use an older version for Federalist
compatibility)
- install via
gem install bundler -v 1.17.3 - use version by
bundle _1.17.3_ ...
- install via
- Node.js 10
Install Node.js dependencies.
$ npm install
Install Ruby dependencies.
$ npm run setup
Run the build.
$ npm run build
Run the server
$ npm start
Open your web browser to localhost:4000.
Sanity check the generated site.
$ npm test
Check for broken links.
$ npm run qa
To update dependencies, you can run bundle update {dependency} after running
npm install. Then follow all other development steps above to validate site is
working as expected.