Recipe for a Style Guide

Wired Online has recently announced its plans to drop capitalization in internet, web, and net, but Wired Magazine continues to capitalize these words. Which should you do? For the most part, it's up to you. To ensure consistency on such tricky words, most editors will have a style guide.

This kind of style is the way you present yourself in words as well as the mechanics of words. Style addresses physical and editorial conventions.

If you don't have the luxury of creating one, there are a few excellent resources for your use. The AP Style Guide and Chicago Manual of Style are the bibles for many editors. When you need to cite another source, use the MLA Handbook or Columbia Guide to Online Style for the rules. Just want a simple, small book you can carry with you? Strunk & White's Elements of Style is a winner.

Be warned that none of the cookbooks has a reference to words like "e-mail" and don't resolve all the issues you may encounter. In this case, you could refer to Microsoft Manual of Style for Technical Publications. Here's what it says about E- words:

"In general, avoid forming new words with 'e-' (for electronic) unless you know your audience will understand. Some words that may be appropriate in certain circumstances are 'e-commerce' and 'e-money.' 'E-mail' and 'e-form' are acceptable. Use lowercase and always hyphenate for clarity."

Here's where creating your own recipe comes in. You can use a few other recipes and throw in your own modifications to come up with what best fits your tastes. Of course, we want to keep our readers in mind when creating the guide.

Start by thinking about the topics you write about. If it is high tech, then it helps to explore all the terms along with the spelling, punctuation, and capitalization. Check out the Jargon File, the online version of The New Hacker's Dictionary or Writing for Multimedia's Terminology. If you're in another field, then you'll want to explorer for a similar resource. BBC News has a radio style guide and the GuardianUnlimited Style Guide is for writers and editors. Example of style guides for building Web sites include Lynch and Horton's Web Style Guide and New York Public Library's NYPL:Style Guide. For those in medicine, University of Washington presents the most frequently used entries from the AMA Style Guide.

The next ingredient to tackle is physical conventions. For instance, when starting a new paragraph, do you indent or use a double hard return? What font size, face, and style will you use for titles? Will the titles be capitalized or in sentence case? This is similar to a cookbook. All the recipes are formatted the same way. Even CSS (Cascading Style Sheets) is a recipe since it ensures formatting consistency.

Once you make the tough decisions, the easy part comes next. You throw all the selected ingredients into one pan, or in this case, one document. The style guide should be organized to make it easy for your writers can find what they need.

Finally, put it where everyone can access it. It doesn't have to be a book. It can be a one or two page document. It's a living document that you can continuously revise. Heck, use a blogging tool to easily manage it.

Now back to the hard part, getting everyone to follow the new guide.

Meryl K. Evans, Content Maven, is the writer and editor of many articles and publications including eNewsletter Journal, Shavlik's The Remediator, and Web Design @ InformIT. To get your feed on things geeky, webby, and wordy or to subscribe to free newsletters, visit her site at http://www.meryl.net/blog/.

In The News:


pen paper and inkwell


cat break through


How To Write Thank You Letters With Class

When I first started tracking the information preferences of people... Read More

Unusual Points of View

Most writers are familiar with first and third points of... Read More

How to Outline your Book and Chapters with Mindmapping

Mindmapping is better than linear outlining because authors can use... Read More

How To Co-Publish For Profits!

The Benefits of Co-Publishing There are a number of publishers,... Read More

The Value of Adding Images to Technical Documentation

It's cliché, but true-a picture does paint a thousand words.... Read More

Is Now the Time for a Play about the War in Iraq?

Everone knows that comedy is mostly about timing. If you... Read More

Get Rich Writing With Your Computer Word Processor

Your computer is a writing machine, a word processor, a... Read More

How to Write a Short Story

Everybody knows writing a story is not easy. Like the... Read More

On Writing and Poetry: Harry Calhoun in Conversation

"This is just brilliant. The whole interview is incredible? I'm?... Read More

The Unwritten World Of The Reality Of Letterwriting

You may wonder why I have chosen this title of... Read More

10 Tips To Help You Pack More Power Into Your Business Writing

1. Before you write anything down define not what you... Read More

Under The Leaded Sky in Serbia by dr Mirjana Radovic

When one population in one century survived five wars, two... Read More

The ENTP Inventor Writes A Novel

People familiar with the Myers-Briggs Personality test know that the... Read More

Apotheosis - the Seminal Insight of the Hero for Screenwriting

Every hero has a seminal insight - the apotheosis. Once... Read More

Writing for the Internet -- How To Give the Readers What They Want

In this article you will find tips on: How to... Read More

Writers Turn to the Internet for Support, Friendship and Advice

Riding on the fumes of potential, you take pen to... Read More

How To Be A Published (Non-Fiction) Author

1. Turning your idea into a bookWith non-fiction books the... Read More

5 Ways to Break the Story Spell

You sink back into your favourite chair with a new... Read More

Finding The Book Writing Resources, Tips, And Help You Need!

Writing can be more difficult that just compiling your thoughts... Read More

8 Great Journaling Tips

Mix a martini, don't forget the olives, or pour yourself... Read More

Know your Audience Before you Write Your Book or Web Site

If you want happy customers to use your service or... Read More

How to Build A Success Freelance Career (Part 2)

Part 1 of this article discussed the experience you need... Read More

How to Relax Your Writing

Q. My writing sounds stiff and stilted. Help!A. Memories of... Read More

COULD YOU (not) REPEAT THAT PLEASE?

I recently read a book where everything was akimbo. Arms... Read More

If You Want to Succeed As a Writer, Dont Just Think It, Do It

It never ceases to amaze me when a prospective writer... Read More

Friendly Critiques

When a writer is working on their next literary masterpiece... Read More

Why Should You Use Worksheets For Proofreading?

Proofreading worksheets are a great tool to help individuals open... Read More

Top 5 Rules of English Grammar

Communication is effective when we follow certain rules. These rules... Read More

Getting Looked Over, Without Getting Overlooked: Writing for Scanners and Skimmers

* Scanning and Skimming Practices *Whether you're writing e-mail messages... Read More

7 Book Publicity Tips for Authors and Small Publishers

The biggest mistake authors make when trying to get free... Read More

Want to start a publishing revolution?

Calling all publishers, editors, journalists and freelance writers. It's time... Read More

Call Yourself a Writer? Where Are Your Notes?

Writers are notorious collectors of slips of paper. They tear... Read More

How to Write Words Worth a Thousand Pictures

Our Image-Driven SocietyWe live in a new image-driven society. It... Read More