Just back from a wonderful, amazing, intense #WriteTheDocs Berlin conference, back in-person (actually, hybrid) in Europe after six virtual years.
Even better: I was one of the MC’s, which is (for me) way too much fun to be allowed.
It felt like coming home. It was coming home.
Even better: I was one of the MC’s, which is (for me) way too much fun to be allowed.
It felt like coming home. It was coming home.
October 29, 2025 at 9:10 PM
Just back from a wonderful, amazing, intense #WriteTheDocs Berlin conference, back in-person (actually, hybrid) in Europe after six virtual years.
Even better: I was one of the MC’s, which is (for me) way too much fun to be allowed.
It felt like coming home. It was coming home.
Even better: I was one of the MC’s, which is (for me) way too much fun to be allowed.
It felt like coming home. It was coming home.
Heard at #WriteTheDocs: "I make typos at scale"
October 28, 2025 at 1:06 PM
Heard at #WriteTheDocs: "I make typos at scale"
October 27, 2025 at 1:17 PM
Super fun, as always, to be part of the #WriteTheDocs welcome wagon this year.
Have a great conference, everyone 🧡
Have a great conference, everyone 🧡
September 23, 2024 at 12:16 PM
Super fun, as always, to be part of the #WriteTheDocs welcome wagon this year.
Have a great conference, everyone 🧡
Have a great conference, everyone 🧡
Next talk: Kim Wallace on becoming an "accidental mentor" #writethedocs
April 16, 2024 at 8:49 PM
Next talk: Kim Wallace on becoming an "accidental mentor" #writethedocs
He also didn't consider the definition of "done", when it came to Jira. Instead of using the completed status, he tried to use the date of the last status change; that means he's vulnerable to one bad batch update #writethedocs
April 16, 2024 at 6:07 PM
He also didn't consider the definition of "done", when it came to Jira. Instead of using the completed status, he tried to use the date of the last status change; that means he's vulnerable to one bad batch update #writethedocs
He has an article that goes into detail at www.stevenhicks.me/blog/2024/04... #writethedocs
How Camunda Docs Handle Canonicals
Out of the box, Docusaurus handles canonical URLs in a potentially SEO-damaging way. Here's how we fixed it for the Camunda 8 documentation.
www.stevenhicks.me
April 15, 2024 at 9:14 PM
He has an article that goes into detail at www.stevenhicks.me/blog/2024/04... #writethedocs
He joined Ripple, a cryptocurrency company. "Everything you don't understand about money combined with every you don't understand about computers." —John Oliver #writethedocs
April 15, 2024 at 4:34 PM
He joined Ripple, a cryptocurrency company. "Everything you don't understand about money combined with every you don't understand about computers." —John Oliver #writethedocs
System documentation is reactive; you have to update the docs after the system has changed. There are varying degrees of granularity and support, and docs tends to omit context and history #writethedocs
April 16, 2024 at 9:22 PM
System documentation is reactive; you have to update the docs after the system has changed. There are varying degrees of granularity and support, and docs tends to omit context and history #writethedocs
Doing a content analysis: gather requirements, determine the current quality of your content, look at the usability of your current docs, and determine alignment with your product strategy #writethedocs
April 16, 2024 at 4:10 PM
Doing a content analysis: gather requirements, determine the current quality of your content, look at the usability of your current docs, and determine alignment with your product strategy #writethedocs
Q: What kinds of metrics do you collect?
Page views and upvotes; they also look at SEO metrics #writethedocs
Page views and upvotes; they also look at SEO metrics #writethedocs
May 5, 2025 at 5:54 PM
Q: What kinds of metrics do you collect?
Page views and upvotes; they also look at SEO metrics #writethedocs
Page views and upvotes; they also look at SEO metrics #writethedocs
When FDA regulations change broadly, each company has to interpret what that means for them. They have to update their docs to meet the new regs and release a new version; sometimes they fall behind #writethedocs
May 5, 2025 at 6:33 PM
When FDA regulations change broadly, each company has to interpret what that means for them. They have to update their docs to meet the new regs and release a new version; sometimes they fall behind #writethedocs
Next talk: Niko Berry on the value of developer personas
#writethedocs
#writethedocs
May 5, 2025 at 8:33 PM
Next talk: Niko Berry on the value of developer personas
#writethedocs
#writethedocs
Q: How do you feel about using AI in the process, especially if you are a solo writer?
"My first thought about AI is: go away". It's hard to say how useful it will be if you can't determine how it makes its decisions #writethedocs
"My first thought about AI is: go away". It's hard to say how useful it will be if you can't determine how it makes its decisions #writethedocs
May 6, 2025 at 9:02 PM
Q: How do you feel about using AI in the process, especially if you are a solo writer?
"My first thought about AI is: go away". It's hard to say how useful it will be if you can't determine how it makes its decisions #writethedocs
"My first thought about AI is: go away". It's hard to say how useful it will be if you can't determine how it makes its decisions #writethedocs
The hardest part: convincing your stakeholders. This is when you have to use your most compelling examples. You get to be aspirational; if the CEO can be aspirational in their plans for the company, you can be aspriational about your content. You can push things out to a phase 2 #writethedocs
May 6, 2025 at 8:52 PM
The hardest part: convincing your stakeholders. This is when you have to use your most compelling examples. You get to be aspirational; if the CEO can be aspirational in their plans for the company, you can be aspriational about your content. You can push things out to a phase 2 #writethedocs
Bluesky's Top 10 Trending Words from the Past 10 Minutes:
️⚠️💨2 - segundou
️⚠️💨2 - segunda-feira
️⚠️💨1 - deutschlandticket
️⚠️💨1 - seabra
️⚠️💨1 - changbin
️⚠️💨1 - teurer
️⚠️💨1 - segundas
️⚠️💨1 - 7h
️⚠️💨1 - kosten
️⚠️💨1 - diddy
(tap/click to see all posts on Bluesky featuring that word!)
September 23, 2024 at 10:20 AM
Bluesky's Top 10 Trending Words from the Past 10 Minutes:
️⚠️💨2 - segundou
️⚠️💨2 - segunda-feira
️⚠️💨1 - deutschlandticket
️⚠️💨1 - seabra
️⚠️💨1 - changbin
️⚠️💨1 - teurer
️⚠️💨1 - segundas
️⚠️💨1 - 7h
️⚠️💨1 - kosten
️⚠️💨1 - diddy
(tap/click to see all posts on Bluesky featuring that word!)
Context switching: users can struggle when switching between text, images, and code samples.
When he worked at Oracle, they anticipated having an O'Reilly book written about their product. #writethedocs
When he worked at Oracle, they anticipated having an O'Reilly book written about their product. #writethedocs
April 15, 2024 at 4:44 PM
Context switching: users can struggle when switching between text, images, and code samples.
When he worked at Oracle, they anticipated having an O'Reilly book written about their product. #writethedocs
When he worked at Oracle, they anticipated having an O'Reilly book written about their product. #writethedocs
They were maintaining both the ForgeRock and Ping websites so their development process was used to deploy to both sites. With their tight timelines it was easier to post content to both sites without having to wrangle redirects #writethedocs
May 6, 2025 at 5:26 PM
They were maintaining both the ForgeRock and Ping websites so their development process was used to deploy to both sites. With their tight timelines it was easier to post content to both sites without having to wrangle redirects #writethedocs
Engineering tests verify code functionality. Document tests ensure document accuracy. They don't replace the engineering tests, they complement them #writethedocs
May 5, 2025 at 11:30 PM
Engineering tests verify code functionality. Document tests ensure document accuracy. They don't replace the engineering tests, they complement them #writethedocs
Github Copilot can do code reviews; they have not used it for doc reviews. #writethedocs
May 6, 2025 at 9:41 PM
Github Copilot can do code reviews; they have not used it for doc reviews. #writethedocs
Eric encourages us to talk about #writethedocs on social media, to spread awareness of the conference. (I think I have that covered.) This was the largest event post-COVID; with virtual attendees this was the largest event to date
May 6, 2025 at 10:10 PM
Eric encourages us to talk about #writethedocs on social media, to spread awareness of the conference. (I think I have that covered.) This was the largest event post-COVID; with virtual attendees this was the largest event to date
Deciding to open your docs cause changes in how they work for your users and your developers #writethedocs
May 6, 2025 at 9:26 PM
Deciding to open your docs cause changes in how they work for your users and your developers #writethedocs
Semantic line breaks: "When writing text with a compatible markup language, add a line break after each substantial unit of thought." #writethedocs
April 16, 2024 at 8:28 PM
Semantic line breaks: "When writing text with a compatible markup language, add a line break after each substantial unit of thought." #writethedocs
After a quick break, we will be back with
Tom Edmonds - "The vibes were off": Adapting Agile story points estimation to technical writing #writethedocs
Tom Edmonds - "The vibes were off": Adapting Agile story points estimation to technical writing #writethedocs
April 16, 2024 at 5:20 PM
After a quick break, we will be back with
Tom Edmonds - "The vibes were off": Adapting Agile story points estimation to technical writing #writethedocs
Tom Edmonds - "The vibes were off": Adapting Agile story points estimation to technical writing #writethedocs
Shawn used the last of his time to thank his collaborators #writethedocs
April 16, 2024 at 9:35 PM
Shawn used the last of his time to thank his collaborators #writethedocs