DesignSafe ReadTheDocs Documentation with MkDocs.
Note
For a detailed walkthrough of how to contribute to Use Cases, see its README.
- Fork this repository.
(unless you are a direct collaborator) - Edit relevant files that need update.
(upload images as necessary) - Commit your changes.
- Request a review.
(a.k.a. create a "Pull Request") - (if comfortable using a command prompt)
Test your changes.
- Have Python installed.
Known supported versions are from 3.10 to 3.12. - Navigate into your clone of this repo.
- Install dependencies:
You should only need to do this once.pip install poetry
- Isolate dependencies:
poetry shell
- Update & Serve the docs:
After the
poetry install cd user-guide mkdocs serve
poetry shell
command, you should be in a Poetry-managed environment. Your prompt might be prefixed with the name of the environment. - Open the website at the URL echoed by the program, e.g. link
- Have Docker installed.
We recommend doing so via Docker-Desktop. - Navigate into your clone of this repository.
- Start the Docker container to serve the docs.
make build make start
- Open the website at the URL provided e.g. http://0.0.0.1:8000/user-guide/
All commits to main
will trigger a docker build and push a new image to designsafeci/ds-user-guide:latest
.
A Watchtower service will monitor new pushes to this dockerhub repo and pull down new images on the fly to https://designsafeci-dev.tacc.utexas.edu/user-guide/