JJLDickinson + technicalwriting   11

An opinionated assault on "login" as a verb. "This is not an attempt to arrest the evolution of the language, but to correct mistakes." I was curious, since the Microsoft Press technical writing guide says one logs ON and OFF, not in and out. Per Wikitionary's "login" entry.
technicalWriting  grammar  computer 
september 2017 by JJLDickinson
How to Present Scientific Findings Online
An itemized list of how to cut the crap for a demanding audience, by Nielsen Norman Group's Kate Meyer; per NN/g's 8/7/2017 "Alertbox" email newsletter.
writing  technicalWriting  publishing  science  NielsenNormanGroup  KateMeyer 
august 2017 by JJLDickinson
Legibility, Readability, and Comprehension: Making Users Read Your Words
Jakob Nielsen distinguishes legibility, readability, and comprehension, and offers concrete guidelines for improving all of them.
JakobNielsen  NielsenNormanGroup  web  webDesign  technicalWriting  typography  legibility 
january 2016 by JJLDickinson
CreateSpace: Self Publishing and Free Distribution for Books, CD, DVD
On seeing what looked like a relatively thin and flimsy book about Selenium on Amazon.com, published using this service, I realized it wouldn't be that hard to make one's self a published author, mention it in resumes and online profiles, and so on. Especially on computer topics, since you can pad insanely with all the screen shots you want!
publishing  self-publishing  vanityPublishing  book  technicalWriting  DIY 
april 2014 by JJLDickinson
Flare 101 | MadBlog: The Official Blog of MadCap Software
Per Jennifer White, in LinkedIn discussion: "breaks down the concepts behind Flare and the easiest ways to get started on a project."
tutorial  documentation  MadCap  blog  technicalWriting  Flare 
june 2013 by JJLDickinson
Tedopres | Technical Documentation, Technical Translations and Technical Illustrations
"Your one-stop shop for all your technical documentation needs"--if you have a broad and deep worldview, and the money to pay for capable, standards-compliant products and services, no doubt. Per MadCap Software, whose Flare 9.1 leverages Etteplan|tedopres' (Pronunciation, please?) HyperSTE application.
software  contentManagement  intellectualProperty  translation  editing  documentation  STE100  writing  HyperSTE  technicalWriting  Etteplan|tedopres  SimplifiedEnglish 
may 2013 by JJLDickinson
Integrating Microsoft Word and Outlook into Team Foundation Server
Source of TeamSpec, a tool for introducing structure to documents early in the life cycle, aiding in maintaining traceability through QA; per John Collingwood. This is the knee of the curve: From bizarrely structured documents full of unintelligible artifacts, apparently created by people with no idea how to use high level Microsoft Word features, to brilliantly conceived components of highly evolved process. (Arthur Clarke pointed out that "any sufficiently advanced technology is indistinguishable from magic." He made assumptions about what the technology's creators had in mind. It could also be indistinguishable from crap.)
TeamSpec  MicrosoftOutlook  MicrosoftWord  softwareDevelopment  structuredWriting  documentation  SDLC  businessAnalysis  technicalWriting  TFS  process  writing 
april 2013 by JJLDickinson
A Few Notes from Too Big To Know | I'd Rather Be Writing
Some fairly deep thinking in this blog entry and resulting comments. Inspired by questions about applicability of WordPress to various publishing tasks in different environments, it begins as a review of David Weinberger's "Too Big to Know"; then touches on availability of specialized information, working alone vs. working in teams, and other topics.
TooBigToKnow  curating  team  introversion  publishing  technicalWriting  helpFiles  WordPress  longTail 
january 2013 by JJLDickinson

Copy this bookmark: