Preorder Book on Amazon.com

Google SketchUp Workshop: Modeling, Visualizing, and Illustrating, the book I co-authored, is now available for preordering on Amazon.com. Check it out.  

Social Media Etiquette

#    @    LOL ...are three of the web's most awkward phrases, according to Brenna Ehrlich and Andrea Bartz, the writers behind the sarcastic blog Stuff Hipsters Hate. This seems particularly true with the hashtag, an obscure symbol previously reserved for punching in numbers during customer service calls and emphasizing that your team is #1! Ehrlich and Bartz's feelings on the subject?

"You see, the majority of society—you know, the people who don't sit in front of their computers tweeting about how "Eating pancakes makes me feel like death now that I'm 30 #notakidanymore"—doesn't understand what the hell you're saying when you tack what amounts to a pound sign onto any given sentence/word in your correspondence (e-mails, etc.). In fact, they could get offended by what you think is an artfully punctuated joke."   Read more

Infographic: Custom Shower Pan Folding & Fastening Techniques

Infographics explain complex or technical information in a visual manner to facilitate understanding. The infographic below was designed and written for construction trades and site supervisors, the men and women out in the field building houses. In general, we made sure to target the information toward this audience by placing a heavier emphasis on visual content over written content. In addition, the infographic format offers a number of potential uses; the user can print it as a poster to hang up, save it as a PDF, view it on a cell phone, send it to friends by email, and share it through social media. This compact format is able to encapsulate an entire story in a clean and concise manner.

The infographic below takes a detailed look at how to properly fold and fasten one type of shower pan liner, a manufactured sheet membrane. The liner serves as the last line of defense against water leaks in a custom shower floor.

Intelligent Content 2011

Intelligent Content 2011 Conference will be February 16-18, 2011 at Hotel Zoso in Palm Springs, California. "Intelligent Content 2011 is all about getting your content delivered to your customer, no matter where they are, or how they’re experiencing it." The call for presentations deadline has been extended to Sept. 15th.

English Version of "Creer avec SketchUp" Book Announced

I recently received good news that Elsevier plans to publish Creer avec SketchUp: 16 projets, de l'architecture au theatre in English. Speaking for the co-authors, we're pretty excited for its U.S. release date in November! That makes it exactly one year since the book was first released in French. Its English title will be Google SketchUp Workshop.

Quality Assurance Tools

Quality assurance, or QA, is the detailed-oriented, structured process of ensuring that everything about a web environment—from its front-end to its back-end—is firing on all cylinders before it goes live. A majority of QA will occur during the testing phase of a web project. However, the beginnings of QA can be traced back to the early phases of a project, even as far back as revisiting the branding guidelines and web style guide to make sure they're up-to-date and available to the team at the start. And taking the time to draft the project specifications (particularly useful for vendors) and document the content requirements up front will help to make sure everyone's on the same page, leading to a better, consistent, and higher quality website down the road.

Other important tools that play an early role in QA include project summary worksheets (which document a project's background information and are very useful in getting team member's up-to-speed), content inventory spreadsheets, and content matrices. A content inventory spreadsheet is a record of the current content on a site, while a content matrix takes that a step further. A content matrix maps all of the content for a website, both current and planned; it can be used to track URLs, content objects, content status, content type, reviewers, authors, deadlines—basically, it acts as a central repository for all things content.

During the testing phase of a web project, checklists are an important QA tool to validate the front and back-end of the site before launch. Click every link, review every webpage, hit play on every video, if possible. In the CMS, open every content module, delete unused material, verify that everything in the back-end is displaying on the front-end. This type of meticulous attention to detail will pay off on the launch date when the first visitors step aboard.

Advice for Writers Pt. 2

"A sense of inferiority, then, in a person, quite often means true inferiority in a craft through simple lack of experience. Work then, gain experience, so that you will be at ease in your writing, as a swimmer buoys himself in water."

- Ray Bradbury, Zen in the Art of Writing: Essays on Creativity (Joshua Odell Editions, 1994)

Style Guide: Homebuilding (Home Building?) Terminology

A style guide is a set of standards to follow when creating and working with content. Some of the most widely-used style guides include the MLA Style Manual and the Chicago Manual of Style.

Industry terminology is a standard component of a corporate style guide. In the homebuilding industry, there are numerous ways to write and use common terminology (probably true of most industries). The following is an abbreviated list of just some of these debatable terms. My favored versions are on the left.

• Home vs. House
• Homebuilding vs. Home building
• Homebuilder vs. Home builder
• Homeowner vs. Home owner
• Homebuyer vs. Home buyer
• Backerboard vs. Backer board
• Blown-in insulation vs. Blown in insulation
• Crawlspace vs. Crawl space
• On-site vs. Onsite
• Low-E vs. Low E
• Slab-on-grade foundation vs. Slab on grade foundation
• Watertight vs. Water tight
• Through-wall flashing vs. Through wall flashing
• Thin-set mortar vs. Thin set mortar
• Unfaced batt vs. Un-faced batt
• Whole-house approach vs. Whole house approach
• Shingle-style vs. Shingle-fashion
• Shingle-style vs. Shingle style
• Weatherstripping vs. Weather stripping
• Housewrap vs. House wrap

Advice for Writers

What is the best advice for writers? Good advice can come from lots of different places, but it's what rings true to you that matters most.

"Read a lot, write a lot." - Stephen King, On Writing (Pocket, 2001)

King's advice is succinct, clear, hard to forget, and most of all, it rings true. To be a serious writer, King says, you should do these two things above all others.

Must You Always Write in Complete Sentences?

No way! However, complete sentences offer real value. To be complete, a sentence must have a noun, a verb, and punctuation. I write. Sally sits. Bobby bounces. Should you choose to deviate from this path of noun-verb-punctuation, do so only as a master of grammar. As William Strunk, the writing style guru, put it, "Unless he is certain of doing well, [the writer] will probably do best to follow the rules." And as Stephen King in On Writing replied, "If you don't have a rudimentary grasp of how the parts of speech translate into coherent sentences, how can you be certain you are doing well?" Language is wonderfully flexible. An incomplete sentence can be as powerful as a complete one, but know that you have to master the rules first before you break them.

Caveat: Of almost equal importance is the medium. There are many mediums—technical reports are one—where complete sentences are not only the norm but are also best suited to the material and the audience. But that's a discussion for another day.

Read more on a similar topic from one of my earlier blog posts: Writing with Style: Rules vs. Folklore.

Mentioned in STC's IDL SIG Newsletter!

The Society for Technical Communication's (STC) IDL SIG mentioned me in its Fall 2009 newsletter yesterday. Pretty cool! Thanks, IDL SIG. Although a few of the details in the blurb are slightly incorrect (we co-authored a case study in the book, the case studies are related to more trades than just construction, and Laurent Brixius is the author), it's still nice to see.

Check out the Member News section on page 15:
http://stcid.ehost.com/wp/wp-content/uploads/2009/10/IDeaL-Fall2009.pdf

"Creating with SketchUp" Book - Publish Date Set for Nov. 6

A book I worked on is getting published on November 6th! The book is "Creating with SketchUp - 16 projects, from architecture to theater." It will be available from Pearson, a publisher in the education industry. Big thanks go out to the coordinator and author of the book, Laurent Brixius, and the co-director and translator, Jean-Philippe Moreux! As well as to my co-author, James Steacy! They helped make it all possible.

It brings together 16 case studies from a variety of people on their different uses of Google SketchUp. James and I co-authored one of these case studies (he acted as the expert in SketchUp, and I acted as the expert in content development and as lead writer). It's a piece that goes in-depth into the story of crafting a technical step-by-step document for construction trades who need to install a window. Follow the links below to learn more about it!

Pearson is releasing the book in French first (as "Creer avec SketchUp - 16 projets, de l'architecture au theatre"). The book might come out in English down the road, probably depending on the success of the French version. Most of the co-authors are English-speakers, so a version in English isn't much of a stretch.

• To read about the book on the publisher's website (in French): http://www.pearson.fr/livre/?GCOI=27440100233890.
• To read about the book on the main author's website (in French): http://www.arch-image.com/wordpress/.
• To read a translation of the post from the main author's website (in English): http://www.pushpullbar.com/forums/sketchup/11619-cool-book-about-sketchup-soon.html#post157358.

Title: Creer avec SketchUp
Subtitle: 16 projets, de l'architecture au theatre
Author: Laurent Brixius
Co-authors: Frédéric Blanc, Matt Chambers, Tim Danaher, David Harned, Takeshi Hashimoto, Alex Jenyon, Timothy S. Killen, John Lang, Lauren A. May, Koenraad Nys, Robert Playford, Nicolas Rateau, Patrick J. Reynolds, Mitchel Stangl, James Steacy, Jean Thiriet, Kim A. Tolman
Collection: Studio Graphique
Language: Francais
Publication date: Novembre 2009
# of pages: 320
Price: 32,00 €