Posts in Documentation
Leveraging integrated tools
For many teams (especially large teams), the team often has a suite of tools in place to help facilitate the development process. It could be Microsoft Visual Studio, Rational Team Concert, or even the Atlassian suite of products. Regardless of the tools in place, if there's an integration across the tools and your team isn't using that integration effectively then you might want to take a look at how you can better leverage all the features you've already paid for.

This tip, stemming from a frustration on the part of an IWST tester who constantly has to manually re-enter data from one tool to another, points to a problem in cross-team workflows. If these tools were not in place, perhaps it wouldn't be that big of a deal. However, since the company has already paid for these tools, it's really frustrating when the testing team can't take advantage to the features simply because people haven't been educated on the implications to other teams of how they use the tools.

If you have these tools in place, pull together a small cross-functional team to look at how people are using the tools. And don't just talk about what you think is happening - really look at what's happening on projects. Based on that, see if there are opportunities to better leverage the integrated features of the platform, and roll out changes supported by training and helping people understand the value gained by the changes.

This tip was part of a brainstorm developed at the September 2011 Indianapolis Workshop on Software Testing on the topic of "Documenting for Testing." The attendees of that workshop (and participants in the brainstorm) included: Charlie Audritsh, Scott Barber, Rick Grey, Michael Kelly, Natalie Mego, Charles Penn, Margie Weaver, and Tina Zaza.
Reduce documentation - charters over test cases
If you're looking to shave some time off of your test documentation tasks, take a look at working some charters into your test plan so you have fewer scripted test cases to write. Charters are simple to document - you start with defining a mission, an anticipated length, and if you'd like a bit more structure you can include a bullet-list of coverage items so you're sure the person who executes the charter hits all the critical parts. Contrast that with a typical Microsoft Word test case template which includes columns for step, expected result, screenshots, data, setup tasks, comments, etc... It's just a lot of work, for (many times) very little return. If you have not tried using charters before, check em' out.
This tip was part of a brainstorm developed at the September 2011 Indianapolis Workshop on Software Testing on the topic of "Documenting for Testing." The attendees of that workshop (and participants in the brainstorm) included: Charlie Audritsh, Scott Barber, Rick Grey, Michael Kelly, Natalie Mego, Charles Penn, Margie Weaver, and Tina Zaza.
Sketching with a pencil
Okay, it's actually The Pencil. The Pencil Project powered by Mozilla.

Pencil

What is that?


The Pencil Project's unique mission is to build a free and opensource tool for making diagrams and GUI prototyping that everyone can use.

Top features:

•Built-in stencils for diagraming and prototyping
•Multi-page document with background page
•Inter-page linkings!
•On-screen text editing with rich-text supports
•Exporting to HTML, PNG, Openoffice.org document, Word document and PDF.
•Undo/redo supports
•Installing user-defined stencils and templates
•Standard drawing operations: aligning, z-ordering, scaling, rotating...
•Cross-platforms
•Adding external objects
•Personal Collection
•Clipart Browser
•Object snapping
•Sketchy Stencil
•And much more...

Licensing and Versions:

Pencil will always be free as it is released under the GPL version 2 and is available for virtually all platforms that Firefox 3 can run. The first version of Pencil is tested against GNU/Linux 2.6 (Fedora, Ubuntu and Arch) with GTK+, Windows XP and Windows Vista/7.

And here's what I created as a trial in a few minutes.

On-Screen Data Entry
FireShot
I found really cool web page capture program over the holiday call FireShot. FireShot is a simple tool that lets you capture and annotate web pages. I needed something that would capture more than a simple screenshot since I couldn't size the page small enough to fit it into one image. This was perfect. Snap the shot, mark it up, send it off. Simple - and it's just a browser plugin. Check it out.