$30 off During Our Annual Pro Sale. View Details »

How to beat technical writer's block

Carl Alexander
November 02, 2019

How to beat technical writer's block

These are the slides from a talk given at WordCamp US 2019.

Alright, so you’re a WordPress developer who wants to share his technical expertise with the world. Maybe you want to write on your own blog. Or maybe you want to try to write a guest post for one of the larger WordPress publications.

A common hurdle when you start writing (and even when you’ve been writing for a while) is the writer’s block. You’re stuck staring at a white page because you’re not too sure what to write about. It’s a frustrating experience for pretty much anyone.

So how can you find ideas for technical articles? This is what we’ll look at in this talk. We’ll go over some of the principles that I use for finding ideas for technical articles.

These principles aren’t only useful for finding ideas for technical articles. They’re also great for talk submissions. (Such as this one!) And my hope is that they remove some of the frustrations that you might have with writer’s block.

You can read the companion article at: https://carlalexander.ca/writers-block/

Carl Alexander

November 02, 2019
Tweet

More Decks by Carl Alexander

Other Decks in Education

Transcript

  1. How to beat
    technical writer's block

    View Slide

  2. Carl Alexander

    View Slide

  3. @twigpress

    View Slide

  4. carlalexander.ca

    View Slide

  5. We see our developer peers
    write wonderful articles

    View Slide

  6. View Slide

  7. View Slide

  8. View Slide

  9. “Maybe I should do the same?”

    View Slide

  10. Obstacle: Writer’s block

    View Slide

  11. “What do I write about?”

    View Slide

  12. “This is ”

    View Slide

  13. Happens to both
    new and experienced writers

    View Slide

  14. Makes us want to stop writing

    View Slide

  15. Warning:
    Not going to talk about goals

    View Slide

  16. What to write about?

    View Slide

  17. Most frustrating thing
    about writer’s block

    View Slide

  18. A lot of sources of material
    for technical writing

    View Slide

  19. We just don’t think about
    them that way

    View Slide

  20. A problem that you faced

    View Slide

  21. We often solve problems that
    we couldn’t find answers to

    View Slide

  22. Others are probably looking
    for answers just like you were

    View Slide

  23. Why not write about it!?

    View Slide

  24. Easier to write about

    View Slide

  25. Better able to empathize

    View Slide

  26. Something you’re working on

    View Slide

  27. A lot of us have side projects

    View Slide

  28. Write about them!

    View Slide

  29. Tried a new technology?

    View Slide

  30. Used a new concept?

    View Slide

  31. Can't always to try
    new things at work

    View Slide

  32. Postmortems

    View Slide

  33. Talk about a concept or
    technology in the wild

    View Slide

  34. Serious effort
    implementing things

    View Slide

  35. Discuss what went well
    and what didn't

    View Slide

  36. Interesting to other
    developers

    View Slide

  37. Valuable when evaluating
    things for a project

    View Slide

  38. Answer questions

    View Slide

  39. Everyone is asking questions

    View Slide

  40. Pick one and write about it

    View Slide

  41. How I wrote my first article

    View Slide

  42. Where can you find
    questions to answer?

    View Slide

  43. Things you wish
    people knew about

    View Slide

  44. Why I started writing

    View Slide

  45. “I feel people should know
    about this”

    View Slide

  46. “I can’t find anything on it”

    View Slide

  47. Not a topic

    View Slide

  48. Not for developers without a
    computer science background

    View Slide

  49. Write for your past self

    View Slide

  50. Your writing process

    View Slide

  51. As important as where
    you get your topic ideas

    View Slide

  52. Developing a
    regular writing habit

    View Slide

  53. Don’t wait for
    inspiration to “hit you”

    View Slide

  54. Try to write every day

    View Slide

  55. Doesn’t matter if it’s not great

    View Slide

  56. About getting used to the idea
    of writing something

    View Slide

  57. It doesn't matter
    how much you write

    View Slide

  58. We feel that we have to write a
    lot every time we try to write

    View Slide

  59. Experiment with
    your writing habit

    View Slide

  60. Specific time of the day

    View Slide

  61. Amount of time per day

    View Slide

  62. Number of words per day

    View Slide

  63. How this played out for me

    View Slide

  64. On writing slowly

    View Slide

  65. Benefits to writing slowly

    View Slide

  66. Writing is about putting
    our thoughts into words

    View Slide

  67. It’s a thinking exercise

    View Slide

  68. Hard to write if
    things aren’t clear in our head

    View Slide

  69. Writing slowly gives
    you time to think

    View Slide

  70. Can take a long time to write

    View Slide

  71. Other things to keep in mind

    View Slide

  72. Not specific to dealing
    with writer's block

    View Slide

  73. Other ways to solve problems

    View Slide

  74. Tempting to say this is
    “the way” to solve a problem

    View Slide

  75. Something that worked for
    you and might work for others

    View Slide

  76. Like this talk

    View Slide

  77. You don't know everything

    View Slide

  78. Limits to our knowledge

    View Slide

  79. Be honest
    about what you know

    View Slide

  80. Saying “I don't know”
    is a sign of strength

    View Slide

  81. Do your best not to be wrong

    View Slide

  82. Try to overcome
    the limits of your knowledge

    View Slide

  83. Fact check yourself

    View Slide

  84. Working proof of concept

    View Slide

  85. Can be time consuming

    View Slide

  86. It’s about practice

    View Slide

  87. Writing is a habit

    View Slide

  88. Doesn’t happen overnight

    View Slide

  89. Writer's block is a setback

    View Slide

  90. Thank you!

    View Slide