README.md

Developer Documentation for the Biomedical Data Translator

This repository hosts templates, scripts and contents for primary software development documentation 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 Translator software development documentation for hosting as readthedocs and is Open Access licensed.

Getting Started

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.

Project layout

mkdocs.yml    # The configuration file.
docs/
    index.md  # The documentation homepage.
    img/      # images
    ...       # Other markdown pages, images and other files.