On Feb 22, 2007, at 4:48 PM, Martinek, Carla wrote: > In a software reference guide, would you/do you number examples?
No. Maybe some people think, "Oh, I've just got to find example 29-3!" but most people look up examples by content. The books I've seen featured numbering of examples under a section only when there were a plethora of examples (and then not always). These examples were never indexed, and the only way to find them was to look up content and see an example of content. I've also seen introductory sentences eliminate the need for numbering even in those cases. What I've seen is example numbering slowly fade away along with figure numbering. Both made sense in more erudite tomes, but seem quaint and bothersome (to me) nowadays. Tarage ______________________________________________ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. DOCUMENTATION & TRAINING WEST 07: THE USER EXPERIENCE April 18-21, 2007 ~ Vancouver BC ~ Marriott Pinnacle ~ free city tour 40+ sessions * free workshops * free iPod offer * www.doctrain.com _______________________________________________ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
