Location via proxy:   
[Report a bug]   [Manage cookies]                
Headshot

I’m Brian P. Hogan, a technical content expert, software developer, teacher, and musician. I am the author of several books including Build Websites with Hugo, Small, Sharp Software Tools, and Exercises For Programmers.

When I’m not writing or teaching, I’m making music.


Latest Newsletter Issue


Latest Blog Post

Return to Structured Content Published April 8, 2025

My biggest frustration with modern docs is that much of the industry standardized on Markdown. And Markdown isn’t semantic. A keyword, a term, a “first use” item all don’t exist. You mix presentation with meaning rather than separating. XML for docs wasn’t fun but it was structured. You could denote terms. You could have actual admonitions. And so the solution seems to be hacks that turn Markdown k to structured docs, embedded HTML spans with classes, and….


Latest Tutorial

Latest Songs

The Angel With Acid Tears Coming Down (Live at Deploy 2021) Gentlemen

See Music for more.


Copyright 2001-2025 Brian P. Hogan