At #WriteTheDocs Berlin in October, a few people told me, unprompted, that my README checklist helped them document something. Maybe it can help you document something too!
GitHub - ddbeck/readme-checklist: A checklist for writing READMEs
A checklist for writing READMEs. Contribute to ddbeck/readme-checklist development by creating an account on GitHub.
github.com
December 1, 2025 at 3:43 PM
At #WriteTheDocs Berlin in October, a few people told me, unprompted, that my README checklist helped them document something. Maybe it can help you document something too!
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
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
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
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
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 🧡
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
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
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
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
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
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
Treating Documentation as a Product
The WriteTheDocs community emphasizes treating documentation as a product, deserving equal rigor and ownership as code. Effective documentation requires intentional design for diverse…
https://compositecode.blog/2025/12/03/treating-documentation-as-a-product/
The WriteTheDocs community emphasizes treating documentation as a product, deserving equal rigor and ownership as code. Effective documentation requires intentional design for diverse…
https://compositecode.blog/2025/12/03/treating-documentation-as-a-product/
December 3, 2025 at 3:15 PM
Treating Documentation as a Product
The WriteTheDocs community emphasizes treating documentation as a product, deserving equal rigor and ownership as code. Effective documentation requires intentional design for diverse…
https://compositecode.blog/2025/12/03/treating-documentation-as-a-product/
The WriteTheDocs community emphasizes treating documentation as a product, deserving equal rigor and ownership as code. Effective documentation requires intentional design for diverse…
https://compositecode.blog/2025/12/03/treating-documentation-as-a-product/
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