Author Topic: New books and reviews section added.  (Read 1593 times)

0 Members and 1 Guest are viewing this topic.

Offline Inactive_A

  • Status: Semi-Active
  • Reader
  • ******
  • Posts: 1070
  • Darwins +5/-3
New books and reviews section added.
« on: November 07, 2008, 02:18:33 PM »
A new books and reviews section has been added.
While not strictly required a standard format similar to slashdots book reviews will make your reviews much more readable and increase the chance of people actually getting or reading the book in question.

Taken directly from Slashdots book review page:
http://slashdot.org/book.review.guidelines.shtml

It is rather wordy, but should serve well as a general guideline.

------ - - - -
Think and sketch: Take notes on the book you're dissecting, and decide how you want to approach your review. Remember that things which may be clear with the book in front of you won't necessarily be obvious to a reader who has only the review to go on. Here are some questions which may help you formulate a non-fiction review:
·   What is the book about? What is the scope?
·   How gracefully do you expect the content to age? If reviewing an updated / revised book (and you have access to the previous edition), in what ways do the revisions add to or detract from the book?
·   Is the title accurate? (i.e. Does Introduction to BingoWidgets For Novices serve as an adequate explanation of BingoWidgets to the average reader with no experience? Or do you find that in actuality, a working acquaintance is practically necessary to understand even the introduction?) This is usually worth noting only if the title is for some reason not a good match for the text -- for instance, if it seriously under- or overstates the book's content.
·   What level of experience is needed to well use the information in the book? Who will find it most useful? Is there an existing, canonical book which already covers the same ground?
·   Is the book readable as well as technically accurate? Is the language stilted, or natural? Are examples easy to follow?
·   Is the book illustrated? Are the illustrations appropriate and well executed?
·   Do any extras come with the book, like a CD-ROM of additional information or code samples? How helpful are they?
·   What's missing from the book? Would it benefit from illustrations, a better index, a final chapter on practical applications?
If reviewing a computer book, begin by introducing things gently.
·   What is a Relational Database Applications Framework Management System Defrobnobdicator, and what does one eat? Don't dive straight into jargon and buzzwords without stopping to say what they mean, or linking to good explanations on a site like WikiPedia if appropriate. Likewise, avoid eccentric spelling and capitalization unless there is a compelling reason to use it.
·   What hardware and software does the author assume readers will be dealing with? (If this book is about software, what operating systems are dealt with? If it's about hacking into a proprietary video game console, will it work only with certain production runs' output?) Don't assume that everyone is running Microsoft Windows on an Intel-based desktop computer, or Debian GNU/Linux on a solar-powered home-brewed wristwatch -- be as specific as makes sense.
·   If the book is about software, under what license or licenses is the software released? How much does it cost? (And are licensing and pricing consistent among supported platforms?)
·   Another thing to remember when reviewing software books: remember that readers are interested in Free and Open Source software as well as the proprietary kind; be sure to address both of these domains. If your review covers a book about an expensive software package, mention at least in passing whether there are cheaper alternatives, especially Free / Open Source ones, and how well the expensive package justifies its price.
For any book, make a point of explaining why you're reviewing it, your background in the topic or genre, and where else people might want to look if they are interested in the basic area the book addresses. Explaining your expectations going in will help ground your review; an OS X book "for newbies" could be perceived very differently by an OS X expert than by a genuine newbie, so don't praise or pan a book without specifying your context and expectations.
·   Did you like previous works from the same author, publisher, or series?
·   Do you have a pressing workplace need for a certain type of computer system, and you bought an introductory book to help you implement it?
·   Did someone recommend the book to you?
For a work of fiction, here are some starting points:
·   Where and when does the story take place? Does it cover an alternate universe, the present day, a span of thousands of years, a single day?
·   Is this book part of a series or otherwise tied to an existing fictional universe?
·   Is there an identifiable central conflict, or a complex of conflicts?
·   What is the tone and style of the narrative? Is it frightening? Clinical? Amusing? Scattered?
·   Do you like the characters? What about them makes them believeable or phoney, dynamic or static?
·   From whose viewpoint is the story told, and how does that affect the narrative?
·   Is the pace satisfying? Did you have to slog through any portion of the story?
·   Does the book remind you (or remind you too much) of others by the same author, or in the same genre?
·   Do any twists particularly inspire? Are there major gaps in the plot or storyline? How satisfying is the ending? (Don't give away too much, of course.)
Write away:
Once you've read the book and taken notes, writing a review may be the easiest part (providing you've read the instructions below on mechanics and style). Writing a Slashdot review should be fun -- and reading it should be, too. Write conversationally but seriously, as you might in a topical letter to an acquaintance who's asked you to send your impressions of a book.
At the same time, please be sure to write a review, not just a summary. Do explain the content of the book, but don't stop there: the whole point of a review is to offer insight on a book's worth, not just whether it has a chapter on interfacing with MySQL. Compare it to other books, explain whether this one met your expectations, criticize, parse.
By the same token, don't feel obligated to defend a poor book for its faultless page numbering and clean, unobstructed margins, or stretch to play up faults in a book you think is excellent in order to appear objective. A reader should know from your review your general impression of the book, and have an idea whether it's one they would benefit from or enjoy.
So write away. Fill your coffee mug, tea cup, or caffeine IV, tap out your review and submit: we assume book review submissions are intended for publication, and reserve the right to edit and publish them (as outlined below).
Here are some notes on style, mechanics, legalities, etc. to bear in mind -- this isn't as short a list as we'd like it to be, but reading these guidelines completely before you start writing will make it far more likely your review will run; reviews which ignore these guidelines may be declined without explanation.
·   Important: If you have a relationship (other than as an ordinary reader) to the author or publisher of a book you're reviewing, disclose that relationship. This means not only cases like "My brother, the author, has given me a million dollars to type this review, and is holding me at gunpoint, while dictating to me from the Amazon review he himself wrote," but also "I used to work at this book's publisher, and was a technical reviewer for this book's three chapters on networking," or "The author is a good friend of mine." Better to disclose more than you think necessary (it can always be edited out if sensible; we'll let you know if we think there's an inappropriate conflict of interest) than less than actually necessary. If in doubt, please speak up.
·   Plan to write a review of 800-1200 words. There is no formal length requirement, but reviews of much less than this frequently don't have enough information to let a reader know if a book is even worth investigating. You're free to write more than 1200 words, too -- some books demand it -- but be cautious that a longer review means more and better information, not just a higher word count. In the end, the book you're reviewing needs to be the guide. Remember, most readers will have less knowledge than you do in your area of expertise -- take some time to bring them up to speed.
·   Write in complete sentences, and use logically connected paragraphs; avoid making your review a list of annotated chapter titles. Don't feel obliged to give each chapter or section equal space in your review; group logically to avoid a formulaic plodding-through ("Chapter 1 covers X, while chapter 2 delves into Z, followed the the 3rd chapter on Q ..."). Address chapters in the way you feel most comfortable, but stepping duly through the Table of Contents is often not the best approach. Which chapters are most important? Are there chapters which are not adjacent but which cover similar topics?
Strive for correct spelling, grammar and punctuation in your review (and proofread with these in mind) but don't agonize over minutia. (Please run your review through a spell-checker before submitting, though.) If you're a hesitant writer, or if English is not your first language, it's a good idea to enlist a friend for advice and initial editing. One of the most common shortfalls in Slashdot reviews as submitted is a scarcity of commas to offset parenthetical phrases; don't be shy with commas.
·   Try not to sound like a marketing campaign. That means:
o   Avoid cliches (this book, which is better than sliced bread, cuts through the clutter to break down to the nuts and bolts of the real brass tacks at the heart of the matter). Write plainly.
o   Go easy on the exclamation marks and glib hyperbole ("This book belongs on every developer's desk!" sounds too much like "You're not going to pay a lot for this muffler!")
o   Be cautious in general about suprelatives and strong adjectives. Don't say a book is "unsurpassed" or "the best available" on a given topic without doing some actual comparisons to likely contenders. Some other words of praise or derision are often used with too little backing evidence: rather than just calling a book "excellent," "sloppy," "boring," etc., provide concrete examples from the text that demonstrate these qualities.
o   Watch your background. Even if each one is sensible by itself, too many adjectives in a sentence (or a review) makes it look like adjective soup. In particular, intensifiers like "very" and "extremely" in most cases can be excised to everyone's benefit.
o   Rhetorical questions are fine in small doses, but not large ones. More than a few rhetorical questions in a review can make it sound breathless and silly.
·   Use quotation marks around chapter and section titles; remember that the title of chapter 5 could be "Applying Bingo to Wingo," but it's not "Chapter 5: Bingto to Wingo."
·   Word processors or Web-page creation programs frequently create incompatibilities which may not be apparent while submitting, like using "smart" (curly) quotes not all browsers can render, or inserting spaces without being told to. Suggestion: use a simple text editor, such as kedit, gedit, or nano (under a Free operating system), and Notepad or similar editor (under Microsoft Windows). Please keep a local copy for yourself -- Murphy's Law is alive and well. Don't use the submissions form as a text editor, since it makes a lousy (and lossy) one.
·   Use American-style ("illogical") quotation marks. That is, place commas and periods inside quotation marks.
"Jump into the air again, but smiling," he whispered, twirling the baton menacingly.

·   Hyphenate compound modifiers (with the general exception of words ending in "y"). Examples:
o   half-height layout (not "half height layout")
o   step-by-step explanation (not "step by step explanation")
o   15-page chapter (not "15 page chapter")
o   Chicago-based chain of coffee shops (not "Chicago based chain of coffee shops")
o   
o   Subject -- This space is for the book's main title. For instance, if you reviewed Going Critical: How The Nuclear Energy Lobby Has Hidden The Dangerous Truth About Giant Rats in Nevada, just type "Going Critical" into this space. Please don't label it further, as in "Book Review: Going Critical" or "Arthur Previnger's "Going Critical," or assign a creative title like "A Scathing Critique of the Nuclear Lobby's Rodent Program."
o   Book Title -- This is the place to put in the long version (if there is one) of the book's title ("Going Critical: How The Nuclear Energy Lobby Has Hidden The Dangerous Truth About Giant Rats in Nevada") or to simply repeat the title if it's short to start with ("Jaws").
This form also asks for your rating: this rating should be an integer from 1 to 10, along the following scale:
8.   Execrable. Possibly fit for lining cages. Only a truly bad book should ever get a 1, and the review should justify this well.
9.   A thoroughly bad book, but not perhaps quite so bad as to deserve a 1.
10.   A "3" book might have flashes of good, but is one you're disappointed with in most respects
11.   Mediocre; it may have some redeeming qualities, but they're overshadowed by the flaws, or is simply mis-aimed. A book might rank a "4" but still be worthwhile for particular readers.
12.   Neither terrible nor terribly good, but with enough good points to make it useful for a fair number of readers.
13.   Decent and useful (or enjoyable), but difficult to strongly recommend for reasons outlined in the review; run of the mill.
14.   A good book; better than merely adequate, though not outstanding.
15.   Very good.
16.   Outstanding, but with enough shortcomings that a perfect score would be stretching things.
17.   Excellent; unsurpassed in its niche, a classic work. A review which makes a book sound merely Good should not be paired with a "10" rating.
This number is rough, and will reflect the weight you assign to every aspect of the book -- from its title, to whether the index is helpful, to whether you think it will still be worth reading in 2, 5 or 50 years. What's most important is that this rating reflect the content of your review. Most books worth reading will cluster in the upper
·   Your review is intended for online viewing, so take advantage of that. Include relevant links to sites that cover the book itself, the author, or the topic. (Most technical books these days have at least a summary page online, and sometimes quite complex sites.) Authors' personal home pages are great, particularly when they show off more of their interests and writing. You may find links to interviews with the author, or (especially with fiction writers) full-blown fan sites.
If you include hyperlinks, make sure they're readable. The hyperlinks that appear in Slashdot stories appear not just in the running text, but in a column on the right hand side of the page for quick reference; they should be as comprehensible as reasonably possible in that context. For instance:
o   "Check out the author's website at http://www.goobernuts.com/index.html" should become
o   "Check out the author's website at goobernuts.com," or (even better)
o   "Check out the author's website." and embed the link.