feat: Render top-level docs using mdbook

Rely on mdbook to render top-level documentation in a concise manner. Using the build-book just recipe the mdbook (including adhoc addition of js requirements for nermaid graphs) is built from a preselected list of documentation files. Afterwards all Rust documentation is collected in a rustdoc subdirectory of the shared documentation output directory.

The watch-book and serve-book just recipes enable a worklow in which relevant files are watched and the output dir is continuously served using an adhoc webserver.

Fixes: #124 (closed) Signed-off-by: David Runge dvzrv@archlinux.org

added scopedocumentation label

requested review from @wiktor

assigned to @dvzrv

added 3 commits

• 1f803264 - 1 commit from branch main
• c9520cdc - feat: Render top-level docs using mdbook
• fa079cb6 - ci(gitlab-ci): Render mdbook for GitLab pages

Compare with previous version

added 3 commits

• 2a7f446e - 1 commit from branch main
• cb5cc853 - feat: Render top-level docs using mdbook
• a61a2528 - ci(gitlab-ci): Render mdbook for GitLab pages

Compare with previous version

mentioned in merge request !133 (merged)

added 2 commits

• 627a0880 - feat: Render top-level docs using mdbook
• c8313967 - ci(gitlab-ci): Render mdbook for GitLab pages

Compare with previous version

approved this merge request

I think it looks okay-ish. The symlinks are ugly but if there's no better alternative...

resolved all threads

merged

mentioned in commit infrastructure@ee7bee72