Documentation

#DevHack: cross-platform testing your tool on GitHub Actions

December 18, 2020

One of the Doctor’s objectives, a documentation tool that converts markdown to SharePoint pages, was to make it usable cross-platform. Initially, I created this as an internal tool for Valo and would only be used on Azure DevOps or GitHub Actions. In the first release, I focussed on making the tool available to others like you and seeing if there was any interest in it.

Read more

Doctor - the static site generator for SharePoint

December 16, 2020

I love static sites! In 2020 I have created ten production sites with various static site generators and a couple of POCs. My favorites are Hugo and Next.js. Doctor logo The story Internally in our team, we did the same. For our Valo partner/client documentation, we used mkdocs as our static site generator.

Read more

Automate publishing process of MkDocs to Static Website hosting in Azure Storage with VSTS

August 16, 2018

For Valo Intranet, we recently started using MkDocs (https://www.mkdocs.org/) for building our product documentation. The great part about MkDocs is that can generate a completely static HTML site based on Markdown files. This makes it easy to maintain and can live in a source-controlled environment. MkDocs is for example used in projects like Office 365 CLI, PnP SPFx React and Property controls for the documentation.

Read more