A pan-company effort to help guide open source use and contributions sponsored by PHUSE.
Explore the guidance »
Report Bug or Mistake
·
Suggest improvement
This guidance was built through the contributions of individuals across multiple companies. Please use the issues to reach out if you have suggestions to improve this document.
Contributions are what make this document valuable. Please reach out via the issues, ask a co-lead, jump straight in with a PR, or get in contact with PHUSE.
- Clone a copy of the repo
- Make some edits to the
.qmd
files. - Navigate to the folder on your clone and run
quarto preview
to see a preview.
As the site is built on main from a gh-action, you don't need to do a 'full' render locally.
If you would like to contribute code, we follow a very simple git flow where there is a main branch, with no develop or staging.
In order to contribute code (assumption is you do not have write access):
- Make a fork of this repo
- Optionally make a branch, then apply your edits and commit them
- Push the code up to your fork, then make a pull request (PR) onto the
main
branch of this repo - The website is built and deployed from a gh-action, so you do not need to pre-render. If you have any new built artifacts from your changes (things created by
quarto render
), please do not commit them to the repo.
Distributed under the MIT License. See LICENSE
for more information.