Skip to content

Files

Latest commit

bdc4a04 · Dec 24, 2024

History

History
This branch is up to date with metalbear-co/mirrord:main.

medschool

medschool

It's what makes docs MD.

  • Tal

Generates a markdown file from a Rust crate's documentation.

medschool will extract the docs from the current directory, and build a nice configuration.md file.

To use it simply run medschool on the directory you want to get docs from, for example:

cd rust-project

medschool

It'll look into rust-project/src and produce rust-project/configuration.md.

Usage

To generate the configuration.md that you see in the docs page we use the medschool tool as such:

cargo run -p medschool -- --input ./mirrord/config/src --output ./mirrord/config/configuration.md

You can also use the --prepend arg to include a file at the start of the generated markdown file.

cargo run -p medschool -- --prepend ./header.txt --input ./mirrord/config/src --output [path to mirrord.dev docs page]