Twitter | Buscar | |
Tom Johnson
Technical writer, blogger, and podcaster. Interested in APIs, simplifying complexity, content strategy, information design, and more.
6.161
Tweets
2.442
Gente que sigues
5.324
Seguidores
Tweets
Tom Johnson 22 mar.
En respuesta a @activevoicer
How did it work out? I'm curious to know if this is a worthwhile and feasible effort.
Reply Retweet Me gusta
Tom Johnson 21 mar.
I'm curious whether anyone is tracking the value of their doc content against various SEO initiatives and position tracking. Do you ever correlate Mktg's goals with documentation keywords and page rankings?
Reply Retweet Me gusta
Tom Johnson 21 mar.
New post: Results from survey about engineers who write documentation
Reply Retweet Me gusta
Tom Johnson 20 mar.
new post: My documentation takeaways from the Boeing disaster -- two essential doc questions to ask for any project
Reply Retweet Me gusta
Tom Johnson 17 mar.
Morning bike ride in Alviso. Not sure where this goes but I'm definitely taking this route.
Reply Retweet Me gusta
Tom Johnson 14 mar.
New post: Should you get a degree in a program? Two considerations to keep in mind
Reply Retweet Me gusta
Tom Johnson 12 mar.
Interesting read on the Boeing disaster: "... one captain call[ed] the flight manual 'inadequate and almost criminally insufficient'" presumably for not "fully disclosing information about how its systems were different from other planes."
Reply Retweet Me gusta
Tom Johnson 12 mar.
En respuesta a @altafakhai
no, not really. i developed my own approach that involves linking schema elements to conceptual explanations that scroll into view when clicked. the release for this isn't until late april, though. at any rate, i'm also generating an output with oxygenxml as an alt. format.
Reply Retweet Me gusta
Tom Johnson 12 mar.
New post: How to encourage risk-taking and idealism without falling prey to cynical attitudes born from experience
Reply Retweet Me gusta
Tom Johnson 11 mar.
New post: XML Documentation for Adobe Experience Manager (AEM) — Integrating documentation and marketing content into a seamless whole
Reply Retweet Me gusta
Tom Johnson retwitteó
Bill Albing 7 mar.
How to design API documentation for opportunistic (active, experiential) learning styles via
Reply Retweet Me gusta
Tom Johnson retwitteó
David Egyes 7 mar.
HT to for the courage to confront our collective deeper fears. "Confronting the fear of growing older when you're surrounded by young programmers" via
Reply Retweet Me gusta
Tom Johnson 6 mar.
RT "How Developers Use API Documentation: An Observation Study" Great tips around systematic versus opportunistic learning preferences, as well as breaking down concept/reference divisions and instead grouping by topic or goal.
Reply Retweet Me gusta
Tom Johnson 6 mar.
Although Gmail's auto-fill writing suggestions are actually helpful, I resent knowing that I’m merely writing cliches like a machine. I feel like it reduces any unique speech expression I might formulate. Perhaps it’s time to turn them off.
Reply Retweet Me gusta
Tom Johnson 5 mar.
En respuesta a @bwest
Thanks for the tips on reading material.
Reply Retweet Me gusta
Tom Johnson 5 mar.
En respuesta a @bwest
cool. Can you point me to places where this juxtaposition technique is expounded upon in literate programming manifestos or other writing?
Reply Retweet Me gusta
Tom Johnson 5 mar.
I love the way Twilio juxtaposes code alongside conceptual narration in their tutorials. For example: I think this is a great design pattern for documenting code. Am also curious if the format could be applied to other genres.
Reply Retweet Me gusta
Tom Johnson 5 mar.
RT A New Luxury Retreat Caters to Elderly Workers in Tech (Ages 30 and Up) so classic. i feel like i'm getting ancient at 43 in SV
Reply Retweet Me gusta
Tom Johnson 5 mar.
En respuesta a @carlosevia
wow, what prompted such a decision at age 12? I think most kids dream of different sort of careers at that age. But it’s still cool to hear that had such a clear focus so early on.
Reply Retweet Me gusta
Tom Johnson 5 mar.
"Corporate exodus narratives: A close look at the tension between the corporation and academia" (i added some fun surveys at the end, but so far have only have 3 academic responses. not really sure why.)
Reply Retweet Me gusta