Tag: Documentation

The Future of Documentation: Ready for Change?

A few weeks ago, I embarked on a journey to explore how OpenAI could change the way users interact with documentation. Imagine effortlessly accessing the information you need without reading through multiple pages. Instead, you just ask a question about configuring or using a tool, and voilร  โ€“ the answer appears before you.

Read more

Integrating Algolia DocSearch into Next.js like Docusaurus

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

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

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

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

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
Back to top