microbiomedata / NMDC_documentation

Document workflows, schemas, and portal
https://nmdc-documentation.readthedocs.io
2 stars 3 forks source link

[!NOTE] ADRs are now being recorded in the issues repository instead of this repository.

NMDC_documentation

Compile documentation for NMDC workflows, schemas/ metadata, and portal

NMDC Schema https://microbiomedata.github.io/nmdc-schema/

NMDC Workflows ReadtheDocs https://nmdc-workflow-documentation.readthedocs.io/en/latest/chapters/overview.html

NMDC Data Portal User Guide ReadtheDocs https://the-nmdc-portal-user-guide.readthedocs.io/en/latest/

Link Checking

Checking for dead links will happen automatically as a GitHub Action on pull requests or commits to main. Link checking is done using lychee.

If you have installed lychee locally, you can run:

lychee ./docs --format markdown --output ./lychee.md

Alternatively you can run via Docker:

docker run --init --rm -it -v `pwd`:/input -w "/input" lycheeverse/lychee /input/docs --format markdown --output /input/lychee.md