Christian Heilmann

[Evangelism Reps] Some tips on Tech Blogging

Monday, April 9th, 2012 at 12:05 pm

As a ramp-up measure for the Mozilla Evangelism Reps program I just finished a first draft of tips and tricks how to approach technical blogging in Mozilla.

Topics covered are:

  • Basics of blogging – being a spokesperson
    • Be professional (no racism, sexism, calling names)
    • No political and religious views
    • Have something to say
    • Speling duz kount
  • Doing research and finding gaps to fill
  • Tone of voice
    • Use active voice
    • Use short sentences
    • Skip the foreplay
    • Give a full disclosure
    • Answer the WIIFM - “what is in it for me”
    • Stick to one thing and explain it well
    • Give credit where credit is due
  • Structuring your post
    • Use proper headings
    • Tell your story
    • Use lists
    • Give away everything at the beginning
    • Add breathing space
    • Extra value goes to the end
  • Linking
    • Link meaningful text
    • Links are proof, not context
    • Know your link targets
    • Test your links
    • Provide “read more” resources
  • Images
    • Link to the resource
    • Use absolute image paths
    • Have a sensible alternative text
    • Crop what is not needed
    • Play nice with people’s bandwidth
  • Multimedia (Screencasts, Audio)
    • Provide a fallback link
    • Keep them snappy
    • Cross-link from the video site
  • Code examples
    • Link the original source
    • Embed readable code (colourcoding, Gists, interactive code examples with JSFiddle/JSBin/Tinker.io/Dabblet)
    • Make your code work
    • Write code for the web
  • Cross-posting and promotion
    • Do not publish the same blog post on different blogs
    • Write targeted smaller posts linking to the main one
    • Link all the resources back to the blog
    • Find outlets to promote the post

A lot of this might appear basic to the casual observer, but I am constantly amazed just how many simple things are done wrong when posting technical content. So I hope this will help some people get started on solid footing.

Share on Mastodon (needs instance)

Share on Twitter

Newsletter

Check out the Dev Digest Newsletter I write every week for WeAreDevelopers. Latest issues:

Dev Digest 146: 🥱 React fatigue 📊 Query anything with SQL 🧠 AI News

Why it may not be needed to learn React, why Deepfake masks will be a big problem and your spirit animal in body fat! 

Dev Digest 147: Free Copilot! Panel: AI and devs! RTO is bad! Pi plays!

Free Copilot! Experts discuss what AI means for devs. Don't trust containers. Mandated RTO means brain drain. And Pi plays Pokemon!

Dev Digest 148: Behind the scenes of Dev Digest & end of the year reports.

In 50 editions of Dev Digest we gave you 2081 resources. Join us in looking back and learn about all the trends this year.

Dev Digest 149: Wordpress break, VW tracking leak, ChatGPT vs Google.

Slowly starting 2025 we look at ChatGPT vs Google, Copilot vs. Cursor and the state of AI crawlers to replace web search…

Dev Digest 150: Shifting manually to AI.

Manual coding is becoming less of a skill. How can we ensure the quality of generated code? Also, unpacking an APK can get you an AI model.

My other work: