Documentation

Doctor was originally created for having a uniformal way of providing the documentation internally at Valo Solutions. The main driver for doctor was to dogfood the Valo products and make it easier for users to maintain documentation on SharePoint.

As we understand that it is not the best experience for developers to write documentation on SharePoint, we created this tool to simplify the process. Doctor allows developers to use tools/applications they are used to, like VSCode and Markdown, and still provide the information on your SharePoint environment.

Doctor follows the concept of many Static Site Generators. These generators make it possible to write your articles/documentation in Markdown and convert them to HTML files.

Doctor is a bit different, as instead of creating HTML files, it makes SharePoint pages instead.

Under the hood, it makes use of the CLI for Microsoft 365.

Better Doctor is a fork of Doctor, which was originally created by Elio Struyf and Dmitriy Van der Elst.

Where to find what

Section	What you find there
Getting started	Installing `bdoctor`, setting up the Entra app registration with its certificate, and publishing your first page.
Content	Everything about your Markdown source: page front matter, navigation, markdown syntax, shortcodes, partials, and multilingual pages.
CLI	The commands you can run: `init`, `publish`, `status`, `cleanup`, `workflow`, and `setup`.
Configuration	Every option you can pass as a command argument, and every setting you can define in the `bdoctor.json` file.
CI/CD	Running `bdoctor` on Azure DevOps or GitHub Actions, so your documentation gets published automatically.
About	Feedback, contributing, the disclaimer, and the license.