~/talk

How To Write Like It's Your Job

Talkat BSidesSF 2020 · 2020-02-23..02-24· [developer-experience, documentation]
links:none on file
slides:none on file

Practical five-step system: admit writing is part of the job, dump a rough first draft, set aside explicit editing time, use concrete tools and checklists, finalize and deliver. Recommends read out loud and let drafts rest, use the free cybersecurity style guide and a local dictionary file called cyber dick that adds ~2,000 terms to spellcheck, ask focused peers for reviews, watch for garden‑path sentences and misleading order (example: 60,000 SSNs extracted), and stop when the checklist is green so work ships and gets paid.

AI-written summary · about

  1. 0:00Introduction to writing
  2. 1:45Know yourself as a writer
  3. 5:17Write the first draft
  4. 6:43Make space for editing
  5. 9:06Edit your first draft
  6. 12:37Use guides and tools
  7. 15:02Keep audience in mind
  8. 17:50Simplify your structure
  9. 19:34Final editing tips
  10. 20:37Profit from your work
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.