/developer.nrel.gov

An issue tracker for NREL's APIs available at https://developer.nrel.gov

Primary LanguageHTML

developer.nrel.gov

Have questions, feedback, or issues with the APIs available at developer.nrel.gov? Contact us or let us know in the issue tracker.

This repository stores the website content and documentation for developer.nrel.gov. Contributions are welcome. To submit a change, fork this repo, commit your changes, and send us a pull request.

Development

The content files to edit are in ./source. To preview your changes you can use the Middleman preview server. To run Middleman:

  1. Install Docker on your computer.
  2. Checkout the developer.nrel.gov repository on your computer (git clone https://github.com/NREL/developer.nrel.gov.git).
  3. Inside the developer.nrel.gov directory, run docker-compose up.
  4. View your changes at: http://localhost:4480/

Linting

If you're working on Swagger documentation, you can run rake lint locally to check for potential warnings or errors with the Swagger specification files.

Deploy

  • Changes committed to the staging branch will automatically be deployed to the staging site.
  • Changes committed to the master branch will automatically be deployed to the production site.

Deploys may take a few minutes after pushing before they show up. You can check the status via the Actions tab above.