As I explore using agents and setting up skills for agents, I came across the Diátaxis approach to technical documentation writing.
It is excellent! The best feeling is when you find an explanation something that you noticed before, but couldn’t quite put into words. That’s how I felt about documentation. Tutorials and How-To guides serve very different purposes, but they are often used interchangeably! Explanation is something that is alway sprinkled everywhere, but it would be good to have separate!
Will try to adopt some of this here.