Skip to content

Instantly share code, notes, and snippets.

@laurencebradford
Last active August 29, 2015 14:11
Show Gist options
  • Save laurencebradford/ab084d5a3241750e6f99 to your computer and use it in GitHub Desktop.
Save laurencebradford/ab084d5a3241750e6f99 to your computer and use it in GitHub Desktop.
writing tips and strategies for web-based content

Note: You can access this gist here: http://learntocodewith.me/writing-tips

We all write. Important Emails, blog posts, copy for a website, notes for work or school, papers, etc.

For people who say they can't write or are "bad" at it ...

Writing is a muscle. You can build it over time. Start with 100 words a day. Build up to 150 the next week, then 200 words a day after that and so forth.

Make writing coherent and digestible. (Because attention spans are shorter than ever, you want your copy -- whether on your site or in an email -- to be easy to read.)

format tips

Note: the following mostly apply for web based writing, NOT academic writing, business plans, grant proposals, fiction writing, etc. Instead, website copy, blog posts, and emails.

  • Underline hyperlinks only, not plain text (or else people may click!)
  • Use bold and italicizations for emphasis
  • Use bulleted/numbered lists and subheadings to help break up text, and make your writing easy to scan
  • Keep paragraphs short -- so that rule about 5 sentence paragraph not true
  • Keep sentences short, also
  • Put important links on separate line (especially in emails) .. Why? Because people open 51 percent of emails on their phone !! Always make important links easy to click because a little iPhone 4 + big fingers = hard to click
  • Also , big blocks of text are especially hard to read on mobile

writing/design tips

  • using language your audience uses
  • design choices your audience will understand (i.e. avoiding crazy hover effects and JS transitions if you're targeting those 65+)... example of this here (http://www.guillaumejuvenet.com/).. it's cool but it takes thought to navigate the site
  • in blog posts, tell stories. (depending on the post/company/goals) be personal.
  • it's all about transparency. They literally share how much each employee earns a month

“Transparency breeds trust, and trust is the foundation of great teamwork.”

helpful writing formula, when you're stuck

  1. identity
  2. struggle
  3. discovery
  4. result
  5. call to action (sometimes)

real life example !

Rough draft ...sorry, may be some profanity. and there will be lots of typos.

Final Version really shows an example of evolution process

No CTA, but could have added at end either: "Check out the Moto 360 today." or "Are you a female smart watch owner? If yes, how do you like your watch? Comment below!"

Writing Tools


Remember, if you confuse people, you lose people. Be consistent. Be reachable. (Put contact info visible everywhere!) Make it so simple for your customers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment