Drupal: The Absolute Beginners Guide to Style Guides

Drupal: The Absolute Beginners Guide to Style Guides

Writing is an art that comes in many forms.  Some forms are structured, others are entirely free from the restraints of any mandated rules or regulations.

No reader expects a poet to quote his or her sources of inspiration.  As with other types of anarchy, poets get to do whatever they want.

You and I, however, are expected to follow certain rules of grammar, punctuation and usage, in addition to getting our facts straight.  To accomplish that, we must find and follow trusted sources.

Otherwise…

A tremendously well-respected man in our community was a guest on a local radio station this morning.  Nice guy. 

His first topic of discussion was the madness of North Korea’s ruler, who recently (according to our esteemed friend) announced that North Korea had just put the first man on the moon.  To celebrate, people in one crowd were supposedly given an extra ration of rice and canned water.

I tried to verify this gentleman’s unnamed source.  The “news” came from the The Onion, who published that bogus tale a year ago.  It was a bizarre joke.  Our friend, however, quoted that unworthy source, to his own discredit.

There are millions of websites that offer opinions, but few are credible sources for questions regarding grammar, spelling or other aspects of the art of writing.  You will avoid discrediting yourself by heeding the most revered sources.  

The Associated Press Stylebook 

ap-styleFor journalists, The Associated Press (AP) Stylebook is an esteemed guide that must be mastered if you hope to become an accomplished news writer.  Used primarily by journalists, this stylebook is an A-Z compilation of roughly 3,000 words and phrases commonly used in newspapers and news writing.  New editions are published each spring.  (No, it’s not “Spring.”  You’ll find this typical error addressed under “seasons.”)

The AP Stylebook unilaterally mandates the wording of many “politically correct” terms.  To adhere to AP style, you must abbreviate California as “Calif.”  You must not use the term “illegal immigrant” and you must use “anti-abortion,” not “pro-life,” for example.

Are we bound by the edicts of the AT stylebook?  No, not in my opinion.  They can adhere to their anachronistic insistence of “Calif.” but I prefer the abbreviation rooted in our postal system instead: “CA.”

I have happily read my copy of the AT stylebook cover to cover repeatedly.  The fruit of my labor came when I took the writing test at The Gainesville Times newspaper.  The editor at the time said I “rocked the test.”  A degree in journalism will get you an interview.  Knowledge of AP style will land the job.

Apart from learning their perspective on such items as when various titles should be capitalized and how baseball scores should be notated, the best part of this particular book is its guide to punctuation.  This ten-page chapter within the book is a treasure.  

The Associated Press Guide to Punctuation is also available as a separate 100-page booklet.  Buy a copy of this valuable resource and keep it handy when you write, if you want to be correct when using:

  • colons or commas
  • hyphens or dashes
  • quotation marks and question marks.

Applying the simple rules of punctuation can prevent rookie mistakes – errors that cause picky people to doubt your credibility – in your writing.

Dictionaries

As an editor of all sorts of works, I have learned to trust Merriam-Webster’s Collegiate Dictionary, 11th Edition.  Don’t ask me why, but this is the dictionary that publishers prefer; therefore, I use it exclusively for questions of spelling and the application of curious words.

I also keep these reference books at hand:

The Chicago Manual of Style

Drupal: The Absolute Beginners Guide to Style GuidesThose resources have been helpful, at times.  Not one of them, however, carries the weight of the most respected measure for writing, formatting or editing manuscripts: The Chicago Manual of Style.

When writers depend on The Chicago Manual of Style (CMS), published by the University of Chicago, you might not agree with their content, but you only have CMS to blame when it comes to grammar, usage, structure, citations or indexes.

The Chicago Manual of Style is the better part of 1,000 pages of what “word geeks” live for: order.  Think of it as a cookbook for writers.

If you cannot find the answer to your questions by lovingly thumbing through your very own volume, you may submit your questions online, hoping your query will be chosen to enlighten writers everywhere.  I, for one, await my monthly Questions & Answers e-mail as others long for their precious sales circulars or favorite magazines.

Click Here for The Chicago Manual of Style’s Questions & Answers

The best part of the entire tome, in my humble opinion, appears on page xiii in the preface (not capitalized, according to Merriam-Webster) of The Chicago Manual of Style’s 15th Edition:

“Most Chicago rules are guidelines, not imperatives; where options are offered, the first is normally our preference.  Users should break or bend rules that don’t fit their needs, as we often do ourselves.”  

And, “Rules and regulations … cannot be endowed with the fixity of rock-ribbed law.  They are meant for the average case, and must be applied with a certain degree of elasticity.”

Sorry, fellow word geeks.  Even CMS admits their rules are meant to be broken, on occasion.  We live in an imperfect world, in spite of our best efforts.

In-House Style Guides

Many organizations have their own style guides. Check the A List Apart Style Guide as a great example.

Somewhere, I believe, is an epitaph that reads, “Here Lies [insert name here], Who Had the Right of Way.”  Some things are not worth dying for; especially, grammar and punctuation.

If your boss (or the ignorant intransigent editor of your in-house style guide) says it’s acceptable to hyphenate adverbs, you are free to pitch a fit, be labeled forever for “not being a team player” or worse.  Or, you may say, “I prefer the way The Chicago Manual of Style suggests, but I understand that language is an art and artists don’t always agree.”

Then, you go to lunch, instead of back to your desk to empty it of your possessions and hope of future earnings.  Perhaps, you also look for work elsewhere; but, fighting over grammatical differences is not worth the risk of losing work.

Think I’m exaggerating?  Here’s the first of last month’s CMS questions:

"A colleague and I have a conflict.  I don’t like the use of and also in sentences like the following: “We walked and also ran the two blocks to the post office.”  I would change the sentence to “We both walked and ran the two blocks to the post office” or “We not only walked but also ran the two blocks to the post office.”  What’s your take on the use of and with also, two words close in meaning?  My colleague says one is a conjunction and the other an adverb, so the combination is fine."

Following Style Guides in Your Work

If you're writing for someone else, avoid conflict over grammar.

When you go to work for a person or a company, they pay you to do things their way.  That applies to “rules” of grammar, in my opinion.  Yes, there are limits.  Yes, they might be wrong.  Yes, you might be right.

In the workplace, I believe managers have the right to set work hours, dress codes, policies on inter-office dating or computer use and whether you must refer the president of the company as the “President,” even if it’s wrong according to all that we hold dear.

Choose your battles.  Quote your trusted sources.  Then, remember it’s always best to have a job when you look for a new job.  

Don’t have a stroke over idiots who use commas as if they were salting french fries.  (Yes, the preferred usage is “french,” according to Merriam-Webster.)

Unless they force you to capitalize “spring.”  That’s when you go to the mat.

Bạn thấy bài viết này như thế nào?: 
No votes yet
Ảnh của Khanh Hoang

Khanh Hoang - Kenn

Kenn is a user experience designer and front end developer who enjoys creating beautiful and usable web and mobile experiences.

Tìm kiếm bất động sản

 

Advertisement

 

jobsora

Dich vu khu trung tphcm

Dich vu diet chuot tphcm

Dich vu diet con trung

Quảng Cáo Bài Viết

 
How to Add a Sitemap to Your Drupal Website

Cách làm một Sitemap trong Drupal Website

I'll be honest and say that I don't believe sitemaps improve your ranking in search engines. However, they do make sure more pages get indexed and that they get indexed more quickly. This article presents evidence that the difference is astounding:

2 mẫu iPhone thế hệ kế tiếp đã được thiết kế và ra đời dưới thời Steve Jobs

2 mẫu iPhone thế hệ kế tiếp đã được thiết kế và ra đời dưới thời Steve Jobs

Một công tố viên ở San Francisco (Mỹ) khẳng định một nguồn tin nội bộ của Apple đã tiết lộ với ông rằng hai mẫu iPhone thế hệ kế tiếp đã được thiết kế hoàn chỉnh và chúng "ra đời trước thời Tim Cook".

Xây dựng ứng dụng Drupal Learn Words trên Mobile

Xây dựng ứng dụng Drupal Learn Words trên Mobile

In this tutorial we'll explore how to make a simple mobile application game with DrupalGap for a Drupal 7 website. Our game will help us learn words in another langauge.

Wordpress Freelancer

 

Wordpress Freelancer