Contributing
Editing Docs
Edit locally with VSCode Quarto extension:
Install jupyter if needed (
pip install jupyter
)Install Quarto extension in VSCode
Clone this repo and open it in VSCode.
Make edits to
.qmd
,.md
or.ipynb
files.
Open the Command Palette (cmd-shift-p on Mac) and select Quarto: Edit in Visual Mode
for What You See Is What You Get editing. Select Quarto: Edit in Source Mode
to go back.
Preview website. Select the Preview icon in upper right, use the keyboard shortcut cmd-shift-k, or use the
Quarto: Preview
command from the Command Palette.Once everything looks good, commit your changes and push to GitHub. If you pushed directly to main, GitHub will automatically build and deploy the new website reflecting your changes. If you are working on a branch, GitHub will build and deploy your changes when you create a pull request and merge your branch into main.
Edit in your browser
- For simple edits, you can edit markdown (
.qmd
and.md
) files directly on GitHub. Again, as soon as you push to main, the website will rebuild to reflect your changes.
Edit in the MAAP ADE
You could also clone the repo in the ADE and use that interface to edit markdown and Jupyter Notebooks, then commit to GitHub the same way.
Preview coming soon???
Running Tests
$ git clone <this-repo> fireatlas
$ cd fireatlas/
$ pip install -e '.[test]'
$ pytest -v tests/
$ pytest -v --runslow tests/ # include long-running tests