This repository hosts templates, scripts and contents for primary technical documentation for Developers and Administrators of the Biomedical Data Translator project ("Translator"; Fecho et al, 2022) of the National Center for Advancing Translational Sciences ("NCATS").
The repository uses the mkdocs
tooling to generate and manage an indexed compendium of the documentation for Open Access licensed hosting on its Official Site (https://ncatstranslator.github.io/TranslatorTechnicalDocumentation/).
The site uses Python (suggest 3.9 or better) and mkdocs. Assuming that you have python and pip on your machine, then install some requirements (including mkdocs) as follows:
pip install -r requirements.txt
The repository already has core mkdocs
configuration and layout, within which additional content may be added.
The following mkdocs
commands are useful for the work:
mkdocs serve
- Start the live-reloading docs server on your computer.mkdocs build
- Build the documentation site.mkdocs -h
- Print help message and exit.
The Translator mkdocs
documentation is hierarchically structured as follows:
mkdocs.yml # The configuration file.
docs/
index.md # the documentation homepage.
faq.md
img/ # shared images
architecture/ # overview of the Translator architecture
index.md
...
guide-for-developers/
index.md # specific hands-on developer documentation, tutorials directory
...
tutorials/
index.md # tutorials/cookbook pages
...
about/
index.md # project details about Translator
...