why does it matter?
how does it help me?
how much of my (physical and mental) bandwidth
does this take?
what are the benefits to my team/company/?
what are the costs/risks?
how many resources does this require?
how many resources does this alleviate?
governance is not a dirty word
find out how your users write and
are you speaking the same language as your users?
are you considering misspellings/typos?
are there additional keywords you can add?
generate new topics
robohelp and madcap both have
git (version control) doesn't work
well with pdfs
pdfs are evil on mobile
just because a spec requires pdf, it
doesn’t mean that your users want it
the number of words you write is not a measure of
success (MoS) or Objectives and Key Results (OKRs)
delivery and engagement are
management (and the bottom line) doesn’t care if
you use two spaces after a period, or if you use
‘displays’ or ‘appears’
flare/framemaker/robohelp/webhelp outputs are all:
docs as code
use the same tools your developers do
• text editors (ms vs code, notepad++)
• unstructured languages
• oXygen xml editor has built-in md conversion
• github/gitlab/microsoft azure
• slack/ms teams
• there are stc-related slacks if you want to get
your feet wet
what are your customers doing/thinking?
what are their pain points?
what are your competitors doing?
anyone know why x is crashing when y?
what’s best practice for x?
you can answer questions, too!