Escaping the Curse of Outdated Docs | Rizèl Scarlett

Описание: Sigh, your docs are broken and outdated. But here's the good news: they don’t have to be!

Documentation is a reflection of the quality of your dev tooling, so if it's broken and outdated that sets the tone for your product's reputation. I empathize with you: as your tooling constantly evolves, keeping documentation up-to-date is challenging, especially when managing multiple programming languages. You already have so much going on. Docs are important, and your time is too.

Join Rizèl for a session on working smarter (and not harder) with practical techniques for integrating documentation into your development workflows. Rizèl will share how to efficiently treat your developer docs as code to ensure your documentation remains reliable and current.

00:00 in this talk…
00:30 escaping the curse of outdated documentation
00:45 setting up the nursery
01:18 differences in building styles
04:28 the impact of outdated documentation
04:54 Rizèl Scarlett and TBD
06:20 lessons learned from managing documentation
07:38 it’s not easy: TBD as an example
08:08 overview of TBD's SDKs: Web5, TBDex, DAP
09:26 supporting multiple programming languages
09:52 who uses it?
10:31 how do we manage our docs? treat them as code!
11:51 testing code snippets
12:45 how it started / how it’s going now: Shnip
15:08 a quick demo
17:23 next steps: Rust
17:52 takeaways
19:04 audience questions and answers

I am a Staff Developer Advocate at TBD, Block's newest business unit. At TBD, we're shifting the paradigm by converting open standards into open source SDKs that make cross border payments and data ownership more accessible for users. I'm responsible for helping people understand how to use the SDKs through documentation, content creation, conference talks, and practical code examples. With a diverse background spanning GitHub, startups, and non-profit organizations, I have cultivated a passion for utilizing emerging technologies to champion equity within the tech industry. I moonlight as an Advisor at G{Code} House, an organization aimed at teaching women of color and non-binary people of color to code. I believe in leveraging vulnerability, honesty, and kindness as means to educate early-career developers.

---

SquiggleConf 2024 was the first edition of SquiggleConf, a yearly conference in Boston for excellent web dev tooling. See https://squiggleconf.com/ to learn more about SquiggleConf 2025: the second edition coming in September 18th-19th 2025 at the New England Aquarium Simons Theater.

SquiggleConf is a production of Squiggle.Tools, a nonprofit organization offering ongoing learning opportunities that enable participants to engage, learn, and advance their careers—regardless of their background or resources. If you want to support us, follow us on social media, and subscribe on YouTube.

BlueSky: https://bsky.app/profile/squiggleconf...
Discord: https://discord.squiggleconf.com
Mastodon: https://fosstodon.org/@SquiggleConf
LinkedIn:   / squiggleconf  
Shop: https://shop.squiggle.tools
X: https://x.com/SquiggleConf