Documentation

Integrating Algolia DocSearch into Next.js like Docusaurus

September 2, 2021

For the new Front Matter website, I needed to integrate search capabilities. Instead of building my own search experience this time, as I did on this website. I wanted to give Algolia a try. The first time that I noticed Algolia was on the Docusaurus website. Docusaurus uses the service to search through all the documentation and works pretty fast and efficiently.

Read more

Use environment variables in Hugo to show branch information

March 2, 2021

For the new documentation website of Doctor, I wanted to do something similar like I did for Pimp Your Own Bike to show a message depending on the version/branch of the site I am using. For the doctor documentation, I wanted to use this method to show a beta message when using the beta site (beta.

Read more

Using Doctor on Azure DevOps to generate your documentation

February 26, 2021

GitHub Actions is hot these days, but still, Azure DevOps is being used in many companies, and I do as well. Doctor a tool for publishing your markdown documentation on SharePoint, works nicely on Azure DevOps as well. Info I will use the doctor sample as the blueprint for this article.

Read more

#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