Brian P Hogan
@bphogan.com
Technical content expert, author, educator, people manager, and software dev. He/Him. http://bphogan.dev
You know I just wrote a book on Vale, right?
November 2, 2025 at 12:37 AM
You know I just wrote a book on Vale, right?
The Wild need all the goals they can get.
October 20, 2025 at 11:33 PM
The Wild need all the goals they can get.
Reposted by Brian P Hogan
Yessss I love AsciiDoc, everyone should use it! It renders natively on GitHub too, by using the .adoc file suffix, so you can even use it for your readmes and the like
October 2, 2025 at 6:42 AM
Yessss I love AsciiDoc, everyone should use it! It renders natively on GitHub too, by using the .adoc file suffix, so you can even use it for your readmes and the like
It bites you when you decide to move to a different platform or try to syndicate content.
Ask me how I know.
Ask me how I know.
October 1, 2025 at 10:42 PM
It bites you when you decide to move to a different platform or try to syndicate content.
Ask me how I know.
Ask me how I know.
Seriously. Asciidoc is probably a good fit. I’ve done docbook and it’s…a lot. But it’s very cool too.
The thing that sparked all this is I keep running into everyone making these incompatible markdown preprocessors and MDX. The need is there. But it’s all nonstandard when other options exist.
The thing that sparked all this is I keep running into everyone making these incompatible markdown preprocessors and MDX. The need is there. But it’s all nonstandard when other options exist.
October 1, 2025 at 9:22 PM
Seriously. Asciidoc is probably a good fit. I’ve done docbook and it’s…a lot. But it’s very cool too.
The thing that sparked all this is I keep running into everyone making these incompatible markdown preprocessors and MDX. The need is there. But it’s all nonstandard when other options exist.
The thing that sparked all this is I keep running into everyone making these incompatible markdown preprocessors and MDX. The need is there. But it’s all nonstandard when other options exist.
I’ve had access to high traffic docs sites and analytics for ages.
People prefer to read when it comes time to LEARN.
Don’t look at views. Look at time on page/watch times.
survey.stackoverflow.co/2024/develop...
People prefer to read when it comes time to LEARN.
Don’t look at views. Look at time on page/watch times.
survey.stackoverflow.co/2024/develop...
Developer Profile | 2024 Stack Overflow Developer SurveyAll RespondentsProfessional DevelopersLearning to CodeOther CodersAll RespondentsLearning to CodeUnder 18 years old18-24 years old25-34 years ol...
survey.stackoverflow.co
June 14, 2025 at 12:56 AM
I’ve had access to high traffic docs sites and analytics for ages.
People prefer to read when it comes time to LEARN.
Don’t look at views. Look at time on page/watch times.
survey.stackoverflow.co/2024/develop...
People prefer to read when it comes time to LEARN.
Don’t look at views. Look at time on page/watch times.
survey.stackoverflow.co/2024/develop...
The only correct answer.
May 29, 2025 at 9:06 PM
The only correct answer.