Skip to content

OpenCloning/OpenCloning_docs

Repository files navigation

OpenCloning documentation

A static site for OpenCloning, hosted at docs.opencloning.org.

Running locally

Install dependencies

To install the dependencies, we used poetry (see poetry installation instructions). In the source directory run:

# install dependencies in ./.venv
poetry install

Update submodules

The documentation uses text from the OpenCloning repositories, via mkdocs include. This allows us to keep a single version of the documentation.

git submodule update --init --recursive

Run a dev server that gets updated as you type

# activate virtual environment
source .venv/bin/activate
# start dev server
mkdocs serve -a localhost:8001

Go to http://127.0.0.1:8001/ and you should see the page.

Adding content

Full documentation on the theme and static site generator used (Material for MkDocs) can be found in the official documentation. There is some extra info in CONTRIBUTING.md.

Content license

The content of this website are licensed under the Creative Commons Attribution 4.0 International License.

Contributing

See contributing.md.

About

Documentation for OpenCloning web app users

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages