- Have CI added to any new SDK repo
- Write tests for new code functionality. Run the tests locally
- Make sure there is an issue created for items you are working on (for tracking purposes and so that the item appears in the changelog for the release). Use the following labels on the GitHub issue:
- Feature (features will appear as “New” item in the changelog)
- Enhancement (these will appear as “Improved” in the changelog)
- Bug (these will appear as “Fixed” in the changelog)
- Branch off of the
developbranch (unless it is a hotfix for production)
- When done, create pull requests against the
developbranch. You can group related issues together in the same PR).
- Make sure all tests are passing and run rubocop
- Assign a reviewer to look over the code
- Use the “DO NOT MERGE” label for Pull Requests that should not be merged
If you make changes, ensure that all gems use the
openstudio-standard gem shipped with OpenStudio to avoid unforeseen consequences (do not include an openstudio-standard dependency in the gemfile).
Follow these steps to generate rdocs for now and existing SDK gems:
- Install NodeJS
- Go to the repository docs file, eg. urbanopt-scenario-gem/docs and type
npm install. Note: access to developerVPN will be needed for this step if within the NREL firewall.
- Move to the root level of the repo, eg. urbanopt-scenario-gem and enter these commands:
bundle exec rdoc --template-stylesheets ./docs/.vuepress/public/custom_rdoc_styles.css npm run build --prefix docs
- Finally, to deploy the docs, enter:
npm run deploy --prefix docs
Rdoc options are controlled with this config file.