Docs Adventure

· Read in about 1 min · (77 Words)
documentation

Maybe reading documentation should be an adventure.

The Problem

In the Hugo docs, several of the pages start with assumptions (especially in the “Getting Started” sections), or ask you to do things that you may have already done. This is a fairly typical scenario for documentation where you ask the reader to “install this” and then “do that” until finally the reader gets to do the thing they actually wanted to do, e.g., write a blog post.