Designers & Developers: Copy and Content Guide

Designers and Developers, I’m planning to write a guide to creating meaningful error messages and instructions to use with any part of your work that a user sees or interacts with.

This isn’t a style guide for laying out code, or anything technical, but a helpful document to refer to when you are creating content that your users will read (however small or mundane that content might seem).

What would you like included in a document like this?

Examples might be:
guide to checkout copy,
login error messages,
more tricky aspects of grammar and punctuation,
naming conventions for web technology and processes,
common mistakes and pitfalls.

I’ve added some suggestions for you to vote for and I’d love to get some more ideas from you too.

I would like ...

You've used all your votes and won't be able to post a new idea, but you can still search and comment on existing ideas.

There are two ways to get more votes:

  • When an admin closes an idea you've voted on, you'll get your votes back from that idea.
  • You can remove your votes from an open idea you support.
  • To see ideas you have already voted on, select the “My feedback” filter and select “My open ideas”.
(thinking…)
Reset

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can vote and comment on it.

If it doesn't exist, you can post your idea so others can vote on it.

Enter your idea and we'll search to see if someone has already suggested it.

  • Hot ideas
  • Top ideas
  • New ideas
    1. a guide to common mistakes in web copy

      Examples might be: Why should my links not be 'click here' when that's what you do? Why is it not enough to give a telephone number and email address on a contact page?

      85 votes
      Vote 0 votes Vote Vote
      Vote
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        I agree to the terms of service

        You'll receive a confirmation email with a link to create a password (optional).

        Signed in as (Sign out)
        You have left! (?) (thinking…)
      • a guide to microcopy

        Those nifty simple sentences that make the difference - examples might be: how do I ask users not to opt-out, or to encourage them to pick a safe password, or reassure them about giving us their details.

        72 votes
        Vote 0 votes Vote Vote
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          I agree to the terms of service

          You'll receive a confirmation email with a link to create a password (optional).

          Signed in as (Sign out)
          You have left! (?) (thinking…)
        • a guide to contact pages and forms

          What information is needed on a contact page? In what order? What call to actions are required? How do I ask for it nicely? Hiw do I reassure users about my intentions?

          58 votes
          Vote 0 votes Vote Vote
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            I agree to the terms of service

            You'll receive a confirmation email with a link to create a password (optional).

            Signed in as (Sign out)
            You have left! (?) (thinking…)
          • a guide to naming things

            We have a homepage and an about page but is it a sign in, sign-in, or signin process? Or a login or log-in? And what do users call it, a menu or navigation? Checkout, check out, or something else completely?

            44 votes
            Vote 0 votes Vote Vote
            Vote
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              I agree to the terms of service

              You'll receive a confirmation email with a link to create a password (optional).

              Signed in as (Sign out)
              You have left! (?) (thinking…)
            • Copy that demands attention!

              I want to know how to write well, but also converts into sales or another action I want the visitor to take.

              Editor: This would focus on how to construct 'calls to action', and helping users take the next step.

              40 votes
              Vote 0 votes Vote Vote
              Vote
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                I agree to the terms of service

                You'll receive a confirmation email with a link to create a password (optional).

                Signed in as (Sign out)
                You have left! (?) (thinking…)
              • 24 votes
                Vote 0 votes Vote Vote
                Vote
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  I agree to the terms of service

                  You'll receive a confirmation email with a link to create a password (optional).

                  Signed in as (Sign out)
                  You have left! (?) (thinking…)
                • Some best practices or advice on how to convince clients that great microcopy is really important

                  Often clients farm out the writing of (micro)copy to their graphic designers, who frequently have little experience as their expertise is in crafting effective visual design, not usable, useful interaction design, forms, and flows (like checkout processes). I find it is often hard to convince clients to spend money on writing microcopy, getting it right, and understanding why it's important - or in fact, that it can be a lot more important to their bottom line than the graphic design.

                  14 votes
                  Vote 0 votes Vote Vote
                  Vote
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    I agree to the terms of service

                    You'll receive a confirmation email with a link to create a password (optional).

                    Signed in as (Sign out)
                    You have left! (?) (thinking…)
                  • a guide on choosing "Your" vs "My" (Account, Photos, etc)

                    Some sites have links like "My Photos/Account/Profile" some use "Your Photos/Account/Profile", which should be used, and in what circumstances?

                    14 votes
                    Vote 0 votes Vote Vote
                    Vote
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      I agree to the terms of service

                      You'll receive a confirmation email with a link to create a password (optional).

                      Signed in as (Sign out)
                      You have left! (?) (thinking…)
                    • a guide to login error messages

                      Examples might be: explaining email address changes, describing common password entry mistakes, what doesn't help and why, how to write errors for inconsistent entry, explaining captcha and similar.

                      12 votes
                      Vote 0 votes Vote Vote
                      Vote
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        I agree to the terms of service

                        You'll receive a confirmation email with a link to create a password (optional).

                        Signed in as (Sign out)
                        You have left! (?) (thinking…)
                      • a section on writing for older people and younger people

                        Are there any specific considerations we should maek for older users and younger users?

                        11 votes
                        Vote 0 votes Vote Vote
                        Vote
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          I agree to the terms of service

                          You'll receive a confirmation email with a link to create a password (optional).

                          Signed in as (Sign out)
                          You have left! (?) (thinking…)
                        • examples of punctuation and grammar for quick reference

                          Maybe you dropped English like a hot potato in favour of Art or CS and now you can't quite remember which side of the quote the comma goes, or what you hyphenate.
                          So a simple primer and reminder would be great, thanks!

                          11 votes
                          Vote 0 votes Vote Vote
                          Vote
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            I agree to the terms of service

                            You'll receive a confirmation email with a link to create a password (optional).

                            Signed in as (Sign out)
                            You have left! (?) (thinking…)
                          • articles with examples of best practice that examine error messages and instructions

                            Not just a style guide, please! I want to see articles from different authors on topics like interaction copy, microcopy, sign up forms etc.

                            11 votes
                            Vote 0 votes Vote Vote
                            Vote
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              I agree to the terms of service

                              You'll receive a confirmation email with a link to create a password (optional).

                              Signed in as (Sign out)
                              You have left! (?) (thinking…)
                            • a section on nouns and verbs relating to the web

                              email, e-mail - tomaytoh, tomartoh?
                              Skype, Skyping, Skyped etc?
                              I tweet, you tweet, they tweeted, we tweetered?
                              We are making up words like they are going out of fashion, so perhaps a section to debate and get some consensus?

                              10 votes
                              Vote 0 votes Vote Vote
                              Vote
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                I agree to the terms of service

                                You'll receive a confirmation email with a link to create a password (optional).

                                Signed in as (Sign out)
                                You have left! (?) (thinking…)
                              • Short form 'personability'

                                For short error messages and guidance, your thoughts on writing 'personable' copy without overdoing it. Hootsuite seem to do this well but I imagine its not an easy balance to achieve -- AM_Doherty

                                10 votes
                                Vote 0 votes Vote Vote
                                Vote
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  I agree to the terms of service

                                  You'll receive a confirmation email with a link to create a password (optional).

                                  Signed in as (Sign out)
                                  You have left! (?) (thinking…)
                                • a guide to what is useful placeholder text

                                  Instead of lorem ipsum what can I do to encourage my client to start creating content. How can I design and develop for actual content in mind

                                  10 votes
                                  Vote 0 votes Vote Vote
                                  Vote
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    I agree to the terms of service

                                    You'll receive a confirmation email with a link to create a password (optional).

                                    Signed in as (Sign out)
                                    You have left! (?) (thinking…)
                                  • a guide to checkout error messages

                                    Examples might be: Describing the right card number, explaining a billing address, explaining a card decline and what to do next.

                                    8 votes
                                    Vote 0 votes Vote Vote
                                    Vote
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      I agree to the terms of service

                                      You'll receive a confirmation email with a link to create a password (optional).

                                      Signed in as (Sign out)
                                      You have left! (?) (thinking…)
                                    • Chocolate

                                      Editor: Well, maybe I'll find a way to include it ... ;-)

                                      4 votes
                                      Vote 0 votes Vote Vote
                                      Vote
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        I agree to the terms of service

                                        You'll receive a confirmation email with a link to create a password (optional).

                                        Signed in as (Sign out)
                                        You have left! (?) (thinking…)
                                      • guidance on tone of voice, particularly when the user's done something 'wrong'

                                        A lot of "You've done it wrong" messages (e.g. on forms, etc.), can sound cold, and may well put off the less confident user. How to make these friendlier to build a sense of confidence in the user.

                                        3 votes
                                        Vote 0 votes Vote Vote
                                        Vote
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          I agree to the terms of service

                                          You'll receive a confirmation email with a link to create a password (optional).

                                          Signed in as (Sign out)
                                          You have left! (?) (thinking…)
                                        • 3 votes
                                          Vote 0 votes Vote Vote
                                          Vote
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            I agree to the terms of service

                                            You'll receive a confirmation email with a link to create a password (optional).

                                            Signed in as (Sign out)
                                            You have left! (?) (thinking…)
                                          • To Donate Some Material

                                            I did some work for an online newspaper that caters to a high-literacy audience and, in the process of doing that project, I compiled a guide of web writing tips from various studies by Jakob Nielsen. The guide is at: http://www.reportla.com/non-cms/web_writing.html. Feel free to take whatever you want!

                                            2 votes
                                            Vote 0 votes Vote Vote
                                            Vote
                                            Sign in
                                            Check!
                                            (thinking…)
                                            Reset
                                            or sign in with
                                            • facebook
                                            • google
                                              I agree to the terms of service

                                              You'll receive a confirmation email with a link to create a password (optional).

                                              Signed in as (Sign out)
                                              You have left! (?) (thinking…)
                                            ← Previous 1
                                          • Don’t see your idea?
                                          • Post a new idea…
                                          • Designers & Developers: Copy and Content Guide

                                            Knowledge Base and Helpdesk