#techcomm #TechWriting #CharJamesTanny
Addressing critical needs driven by the dynamic world of #techDocs, Manny Silva has created Docs as Tests, a system that integrates well-developed #techComms practices and a collection of engineering tooling to help #technicalWriters streamline and constantly improve their software #documentation and #QA work.
This was a fun chat with a deeply experienced Silicon Valley #content veteran. I hope you enjoy the conversation as much as I did.
This week on Stained Glass Woman, I've got something unusual for y'all: a seven-year research project looking at #syllabus #design that I couldn't get published in any peer-reviewed journal. It's my hope that anyone who's a #teacher or works in #TechnicalWriting / #TechComms can make use of the research I did, peer reviewed or no.
And if you're here for my stuff on gender, don't worry--we're gonna dive into Judith Butler next week!
https://stainedglasswoman.substack.com/p/student-engagement-from-the-syllabus?sd=pf
The #WriteTheDocs talk by @sarah11918 about encouraging community-driven documentation was very helpful. Sarah introduced the power of the Not Worse Than What We Had Before (
#NWTWWHB ) approach to accepting contributions to docs.
@lananovikova reflects on this talk: https://twitter.com/_Unsolved_/status/1601158921024024576?t=X0tZYD2e-RNeSGUVoIpPJg&s=19
“I should make a poster with this phrase. @astrodocs follows #NWTWWHB (Not Worse Than What We Had Before) principle. Kudos, @sarah11918 for a great talk on how to make community-driven documentation shine and create a comfortable process for everyone. #writethedocs @WriteTheDocsAU”
Over the last couple of days I have been attending the Australian Write the Docs conference, learned a lot and had some great conversations.
One thing I learned about was Simplified Technical English:
https://twitter.com/perkinsy/status/1601171073500090368?t=7DmwNDwDSHwAB_XulV4okQ&s=19