| Search | Refresh |
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 1 |
|
|
||
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 17 |
|
Found this post on "generating" API documentation, which got me thinking about the verb(s) developers use to describe documentation authoring vs. the verbs(s) #techcomm uses to #writethedocs and what that means.
medium.com/@olotintemitop…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 2 |
|
[With] "bad survey questions, you get bad data at scale with no chance of recovery."
A short, but valuable, must read for anyone contemplating a survey. #techcomm #writethedocs twitter.com/mulegirl/statu…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Sep 9 |
|
Well, I might as well just admit it.
I'm not going to get much done as long as the live tweets are coming out of the #writethedocs conference.
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Jun 17 |
|
I wonder if saying, “I don’t know” would make the answers tech gives more credible or make the tech seem less trustworthy? #writethedocs twitter.com/bendhalpern/st…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Oct 21 |
|
Ouch! Does this sound right to those in #techcomm and who #writethedocs? twitter.com/MeasuringU/sta…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 1 |
|
Fascinating research. Talk about getting to know your audience!
#techcomm #apidocs #writethedocs twitter.com/SvenApel/statu…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 4 |
|
Interesting observations coming out of #sigdoc18, this weekend...
#techcomm #writethedocs twitter.com/JasonCKTham/st…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 27 |
|
This thread talks about a problem with having too narrow of a focus. It’s easy to show action, but do you make actual progress?
I’ve seen where these observations apply to the #techcomm that supports these projects, as well. #writethedocs twitter.com/jasongorman/st…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Sep 10 |
|
This photo captures so many cool aspects about #writethedocs
* Amazing audience
* Great speakers
* Interesting topics
* Live captioning
* Live streaming
* Live tweets twitter.com/ouebguy/status…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Jul 24 |
|
So, what can we call documentation for a similar effect? Most of the reader's goals WRT documentation also occur offline.
Solutions?
Success Augmentation?
Whachagot #techcomm #writethedocs? twitter.com/aliciaverbs/st…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 20 |
|
So far, I've found 114 articles on API documentation and I'm thinking of organizing them for a study. I'm wondering what aspects #techcomm, #writethedocs, and @stc_org think might be interesting?
I started by target audience. docsbydesign.com/2018/08/17/mor…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Mar 12 |
|
Reviewing your GitHub account seems to be the CV equivalent of "just read the code" for documentation. Sure it might work, but there are more efficient ways to communicate with the audience. #techcomm #writethedocs benfrederickson.com/github-wont-he…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Feb 3 |
|
I love it when I find an article on content metrics that makes me smile. medium.com/contentstrateg… provides advice that even #techcomm should heed. Love the quote from Mike Powers: "Pageviews aren’t the goal. Your goal is the goal." #writethedocs twitter.com/hilarymarsh/st…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Jun 9 |
|
“Any fool can write code that a computer can understand. Good programmers write code that humans can understand.”
— Martin Fowler
Maybe there’s an opportunity for #techcomm to help devs write more readable code? #writethedocs twitter.com/ThePracticalDe…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Aug 27 |
|
Good things for #techcomm to keep in mind when communicating the value of APIs to a broader audience. #apidocs #writethedocs twitter.com/apievangelist/…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Feb 20 |
|
I'm not a fan of using ROI for #techcomm, but this is a great article about using the need to demonstrate ROI as a reason to develop meaningful measurements and benchmarks (and they cited references!) uxmatters.com/mt/archives/20… #writethedocs
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Feb 6 |
|
That makes more sense.
The challenge with doc feedback is nobody (but #techcomm and #writethedocs folks) think about 'em until they need 'em. It's a rare and delicate moment because they think about 'em just long enough to not have to think about 'em anymore.
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Jun 17 |
|
I love it when documentation is part of the design & code. #techcomm #writethedocs twitter.com/ThePracticalDe…
|
||
|
|
||
|
|
Bob Watson, PhD
@bobwatsonphd
|
Jun 13 |
|
I love it when devs talk about documentation. #techcomm needs to be alert for these moments to:
- help answer their questions
- share tips and tricks
- meet allies for future conversations
- learn more about their audience
#writethedocs twitter.com/ThePracticalDe…
|
||
|
|
||