Brian P  Hogan's Avatar

Brian P Hogan

@bphogan.com

Technical content expert, author, educator, people manager, and software dev. He/Him. http://bphogan.dev

996
Followers
515
Following
177
Posts
01.05.2023
Joined
Posts Following

Latest posts by Brian P Hogan @bphogan.com

This is the key though. Use AI tools on domains you understand well so you can guide them.

They accelerate your work. They don’t replace expertise.

04.01.2026 16:54 πŸ‘ 3 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

Another good one. Nicely done

01.01.2026 03:50 πŸ‘ 4 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0

Issue 48 of my newsletter ships later today. It includes a markdownlint tutorial. Subscribe at https://newsletter.bphogan.com/ to get the latest issue in your inbox.

31.12.2025 17:49 πŸ‘ 3 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

Just pushed publish on my 4-song Christmas EP. Traditional songs in my style. If you celebrate, give a listen. https://soundcloud.com/bphogan/sets/december

22.12.2025 22:47 πŸ‘ 4 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

I'm a subscriber, and I can vouch for the fact that it's good. And free, as he said :⁠-⁠)

30.11.2025 21:39 πŸ‘ 1 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0

You are most kind, sir.

30.11.2025 21:38 πŸ‘ 2 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0
Preview
Code, Content, and Career with Brian Hogan A monthly newsletter with opinions and advice about software, technical content creation, and career development.

I have published my newsletter for 47 months straight.

Are you subscribed? It’s free. Once a month.

newsletter.bphogan.com

30.11.2025 20:56 πŸ‘ 2 πŸ” 0 πŸ’¬ 1 πŸ“Œ 1
Write Better with Vale Master the art of technical writing with Vale, the powerful prose linter

thevalebook.com

02.11.2025 00:47 πŸ‘ 2 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

You know I just wrote a book on Vale, right?

02.11.2025 00:37 πŸ‘ 1 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

The Minnesota Wild plays at the Grand Casino Arena and airs games on FanDuel Sports Network, and we are supposed to be surprised there’s a current sports betting scandal in another sport?

24.10.2025 14:30 πŸ‘ 3 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

β€ͺThe Wild need all the goals they can get. ‬

20.10.2025 23:33 πŸ‘ 0 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

HOW DARE YOU, MR. HOCKEY PLAYER!

HOW DARE YOU USE YOUR HOCKEY STICK TO PUT A PUCK IN THE NET!

NO GOAL FOR YOU!

20.10.2025 23:30 πŸ‘ 1 πŸ” 0 πŸ’¬ 2 πŸ“Œ 0

I can only be friends with people who are old enough to remember the annoyance of suddenly having to use area codes even for local domestic calls

we used to only have to remember seven digits!

14.10.2025 00:04 πŸ‘ 257 πŸ” 16 πŸ’¬ 0 πŸ“Œ 0

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

02.10.2025 06:42 πŸ‘ 1 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0

It bites you when you decide to move to a different platform or try to syndicate content.

Ask me how I know.

01.10.2025 22:42 πŸ‘ 1 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

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.

01.10.2025 21:22 πŸ‘ 0 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

Yesterday I published Issue 45 of my monthly newsletter, and it's about why Markdown might not be the best way to implement content.

Read it and subscribe to be the first to read next month's issue.

https://newsletter.bphogan.com/archive/issue-45-markdown-is-holding-you-back/

01.10.2025 20:53 πŸ‘ 5 πŸ” 2 πŸ’¬ 1 πŸ“Œ 1

You don’t say?

https://www.psypost.org/frequent-ai-chatbot-use-associated-with-lower-grades-among-computer-science-students/#

28.09.2025 01:14 πŸ‘ 1 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

Everyone wants corporate sponsorship of OSS until they find out that sponsorship means control. Do what we want or the money you depend on goes poof.

No free lunch. Disappointing.

https://joel.drapper.me/p/rubygems-takeover/

26.09.2025 00:18 πŸ‘ 5 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

"Let's all band together to get consumer protections rolled back, and we'll say it will increase competition" is a hell of a sales pitch.

https://tinyurl.com/2s44zc9j

24.09.2025 14:42 πŸ‘ 0 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

Do you remember…
The 21st night of September…

21.09.2025 23:59 πŸ‘ 2 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

I recommend it.

11.09.2025 00:49 πŸ‘ 1 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

Vale is my go-to tool to catch style errors and enforce consistency in content, and after implementing it in multiple jobs and projects, it was time to create a guide anyone can follow. Now in beta.

https://pragprog.com/titles/bhvale/write-better-with-vale/

10.09.2025 14:51 πŸ‘ 1 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

Hyphen: -
Underscore: _
Em-dash: β€”
En-dash: –

So many dashes…..

09.07.2025 21:40 πŸ‘ 1 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

You β€œlog in” with your login.

Your users β€œsign up” for your service and you track β€œsignups.”

Go check your buttons.

03.07.2025 20:42 πŸ‘ 5 πŸ” 2 πŸ’¬ 1 πŸ“Œ 0

Today, I used ChatGPT o3 to research two articles for my newsletter.

Every article it found was current and relevant.

Every fact it cited was made-up. The statistics did not appear in the article cited.

Content without curation will be painful.

30.06.2025 16:59 πŸ‘ 7 πŸ” 2 πŸ’¬ 0 πŸ“Œ 0

Some things I learned while using Claude Code on some personal projects over the last two weeks. https://bphogan.com/2025/06/19/2025-06-19-claude-code-tips/

19.06.2025 16:49 πŸ‘ 4 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0
Developer Profile | 2024 Stack Overflow Developer SurveyAll RespondentsProfessional DevelopersLearning to CodeOther CodersAll RespondentsLearning to CodeUnder 18 years old18-24 years old25-34 years ol...

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...

14.06.2025 00:56 πŸ‘ 0 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

With major providers down, this feels like a snow day, where the school's closed and all the work that was due today is now due tomorrow.

12.06.2025 19:41 πŸ‘ 1 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

Centralizing everything behind a couple of cloud providers really does help us build things faster. But when there's an outage, you really feel it.

12.06.2025 19:36 πŸ‘ 4 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0