Hugo
Writing workshop instructions with Hugo and deploying in OpenShift
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. Continuer la lecture
Writing workshop instructions with Hugo, with variables in your content
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. Continuer la lecture
Writing workshop instructions with Hugo
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! Continuer la lecture