Showing posts with label style. Show all posts
Showing posts with label style. Show all posts

The Associated Press Stylebook and Libel Manual Review

The Associated Press Stylebook and Libel Manual
Average Reviews:

(More customer reviews)

While the media run rampant with flimsy leads and stories based solely on hearsay, it's good to know that at least their grammar stays in check, thanks to the hard and fast rules set forth in the Associated Press Stylebook and Libel Manual.
Providing direct distinctions between similar words, the correct spelling of commonly-misspelled words, and the politically-correct use of dangerous words, the AP stylebook delineates specific style rules for virtually every journalistic possibility. Set up in a dictionary-style format, the manual's general stylebook lists everything from the perils of "a" versus "an" to the preferred usage of ZIP codes.
Following the stylebook are the more specific sections dealing with sports and business style, both also set up with A to Z listings, including usage and spelling. Although sports writing info may be confined to the needs of the sportswriter, the business section is helpful for those who take interest in corporate designations and definitions of stock market terms.
Finally, just before the manual switches from the absoluteness of style to the murky legal waters of the libel section, comes, in my opinion, the pièce de résistance-A Guide To Punctuation-music to the ears of syntax-psychos and grammar-Nazis, alike.
Starting with words of wisdom from what the AP refers to as "a bible of writers," "The Elements of Style," this portion is eleven pages of invaluable knowledge for any writer, regardless of profession, and is arranged so succintly that even children can access its information for their own use.
Although I have thus far had little use for the information about libel in this book, it is primarily what its introduction claims-not a libel text, but merely a useful guide which "explains the fundamental principles in libel for working writers and editors." It also contains some key parts of the Freedom of Information Act which should be read by everyone to fully know our rights regarding the access to federal information, during what has now become the Age of the X-file.
All-in-all, the AP Stylebook and Libel Manual should be a welcome edition to any writer's reference library.

Click Here to see more reviews about: The Associated Press Stylebook and Libel Manual

The style of the Associated Press defines clear news writing. In fact, more people write for the AP news service than for any single newspaper or broadcaster in the world. The AP Stylebook is therefore "the journalist's bible," an essential handbook for all writers, editors, students, and public-relations specialists.The AP Stylebook contains over 5,000 entries laying out the AP's rules on grammar, spelling, punctuation, and usage. It gives journalists the references they need to write about the world today: correct names of countries and organizations, language to avoid, common trademarks. Special sections cover business and sports reporting. This edition, published in the Associated Press's 150th year, also includes crucial advice on how writers can guard against libel and copyright infringement.An up-to-date AP Stylebook belongs on the desk of every working writer.

Buy Now

Click here for more information about The Associated Press Stylebook and Libel Manual

Read More...

Microsoft Manual of Style for Technical Publications Review

Microsoft Manual of Style for Technical Publications
Average Reviews:

(More customer reviews)
I frequently document software that uses Windows GUI elements. So I've been using the WinHELP and HTMLHelp versions of the MS MOS for several years: Those earlier online versions of Microsoft's Style Guide made it easier and faster to take a quick look at a GUI naming or usage convention.
Lamentably the CD-ROM that accompanies the new version 3 of the MS MOS is a giant step backwards in usability. That's because the two PDF "e-books" (MOS and Networking Encyclopedia) on the CD-ROM are entirely static -- they contain NO clickable links WHATSOEVER.
What this means is that if you locate an entry in the on-line version's TOC or Index, you must use the "go to page" tool in Adobe Acrobat Reader to go to the page.This is an especially silly situation given that the PDFs meta-properties indicate that Microsoft used Adobe FrameMaker 7.0 (not Word) to produce the Style Guide: FrameMaker creates clickable cross-references by default, meaning that Microsoft manually disabled them as part of producing the Style Guide's PDF! (The third item on the CD-ROM, the Computer Dictionary comes as an HTMLHelp .chm file, so there are no problems with navigation there...)
If you intend to buy the print version of the MS MOS you'll be satisfied. If you intend to buy this book because you want the latest, greatest *on-line* version of the Style Guide, FORGET IT.
------
08 July, 2008 UPDATE. After using the PDF for about three years, I'm even more frustrated by Microsoft's incomptence. In the name of "intellectual property" (one of Microsoft's favorite words), the company has created a nearly-useless PDF while failing to truly achieve its misguided security aims.
As I said in my original review, the lack of clickable cross-references means you must instead manually go to a page listed in the TOC or Index. But wait -- the geniuses at Microsoft didn't bother to correlate the PDFs logical and physical page numbers. Yes, if we have full-featured Acrobat we can manually number the pages so that when we tell Acrobat or Reader to go page "x" it actually displays the desired page and not page "x-4" or thereabouts. But why should we have to do that?
But wait, it gets worse. We can't use full-featured Adobe Acrobat (as opposed to reader) to extract pages from the PDF and save them as a separate PDF. BUT we can -- and here's the absurdity -- delete all pages we don't want to extract and save the result of that as a PDF. So we can extract pages, but not directly...
We also can't print *any part* of the PDF. So if we want to print, say, four pages about heading usages we can't do that. The style guidelines are in some way "proprietary" I guess, and so simply must be protected against unauthorized sharing...
Then, too, while looking for a way to print a few pages, I discovered that I couldn't export the PDF as a Postscript or encapsulated Postscript, but I could export it as a Word or Word RTF file. So we can save the contents in some unlocked formats but not others. Brilliant...
In the end, Microsoft's preoccupation with "locking up" the online version of its Style Guide has only succeeded in wrecking the Guide's usability while only partially achieving the desired level of security. How like Microsoft to get it wrong that way...

Click Here to see more reviews about: Microsoft Manual of Style for Technical Publications


Developed by Microsoft's senior editors and content managers, this manual of style captures the up-to-date standards and best practices for delivering clear and consistent technical communications. Now in its third edition, this popular reference has been fully revised, expanded, and optimized for ease of use. You'll find new coverage on meeting the needs of a global audience, accessibility concerns, and the latest technical terms and acronyms-along with expertly organized sections on usage, grammar, punctuation, tone, formatting, and common style problems. Whether you're creating print documentation, online help, Web content, or other communications, you'll get the information and examples you need to maximize the impact and precision of your message.

Get clear, concise guidance to help you:

Use technical terms correctly and consistently-including do's, don'ts, and alternatives for usage.
Employ the appropriate tone and voice for your audience.
Produce written and visual content suitable for a worldwide audience.
Apply best practices for writing and tagging Web content.
Write better documentation-from dialog boxes and error messages to Web pages and software code.
Know the standards for creating accessible communications.
Optimize your indexes, cross-references, and keyword lists.
Get fast answers on spelling, grammar, and punctuation.

CD includes:

Complete eBook inside

A Note Regarding the CD or DVD

The print version of this book ships with a CD or DVD. For those customers purchasing one of the digital formats in which this book is available, we are pleased to offer the CD/DVD content as a free download via O'Reilly Media's Digital Distribution services. To download this content, please visit O'Reilly's web site, search for the title of this book to find its catalog page, and click on the link below the cover image (Examples, Companion Content, or Practice Files). Note that while we provide as much of the media content as we are able via free download, we are sometimes limited by licensing restrictions. Please direct any questions or concerns to booktech@oreilly.com.


Buy Now

Click here for more information about Microsoft Manual of Style for Technical Publications

Read More...