Hugo on Nicolas Massé

Writing workshop instructions with Hugo and deploying in OpenShift

Wed, 27 Feb 2019 00:00:00 +0200

This is the third part of my series covering how to Write workshop instructions with Hugo. In this article, we will deploy our Hugo mini-training as a container in OpenShift.

Writing workshop instructions with Hugo, with variables in your content

Thu, 21 Feb 2019 00:00:00 +0200

This is the second part of my series covering how to Write workshop instructions with Hugo. In the first part, we saw how to:

bootstrap a website with Hugo
add content, organized in chapters and sections
customize the look and feel to be suitable for workshop instructions

For this second part, we will add variables to our content so that we can easily adjust the workshop instructions to different use cases.

Writing workshop instructions with Hugo

Wed, 20 Feb 2019 00:00:00 +0200

In my professional life, I often have to lead workshops with customers or partners. During those workshops, participants expect to be trained on a piece of technology or software.

I usually have to provision everything needed to deliver this training and write the training instructions. Those instructions are organized as a step-by-step guide with screenshots, text, verbatim sections, links, files to downloads, etc.

And maybe more important, those instructions have to be well organized, each step has to be clearly stated, identified and formatted. The progression needs to be logic and easy. At any time, the participant needs to know where he is, which steps he has completed and which steps remain.

And for the trainer, it has to be easy to maintain and collaborative.

Crafting support materials that can meet all those requirements is challenging. Slide decks could fit the participants needs but are very difficult to maintain for the trainer. Markdown documentation in a GIT repository are better for suited for maintenance and collaboration but is difficult to work with for the participants.

Hopefully Hugo can help us!