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.
- Create a "Pull Request".
- 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 poetry install
- Serve the docs:
After the
poetry shell 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. http://127.0.0.1:8000/user-guide/
- 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/