/docs

CyVerse USA Core Software documentation

Primary LanguageHTMLOtherNOASSERTION

A special thanks to Mojib Wali of CyVerse-Austria, Graz University of Technology, Austria, for creating these Materail MkDocs documents for the global CyVerse developer and maintainer community!

========================== CyVerse Core Software Documentation

.. image:: https://github.com/cyverse/docs/actions/workflows/gh-actions.yml/badge.svg :target: https://github.com/cyverse/docs/actions/workflows/gh-actions.yml

These documents are for the deployment and maintenence of CyVerse

MkDocs deploy GitHub Action

The main branch uses deploy-mkdocs GitHub Action.

Do not commit changes directly to the main branch unless necessary. Please commit your updates to the mkdocs branch, test on CodeSpaces or locally, and then commit those merges back to main.

Commits to main will trigget the Action which re-builds and deploys the website to https://docs.cyverse.org -- which is publicly available.

Render with Material Theme

To change to MkDocs Material theme, change Action to @master and set theme: material in the mkdocs.yml:

theme:
  name: material

Build and test locally

git clone https://github.com/cyverse/docs
cd docs
pip install -r requirements.txt
python -m mkdocs serve