Re: Table layout - Which way is best?

Subject: Re: Table layout - Which way is best?
From: Mike Starr <mike -at- writestarr -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Mon, 11 May 2015 22:00:28 -0500

I use a similar approach for callouts. I use vector-based numbers (white numbers in orange circles) that get laid over the illustration (they're separate from the illustration, the illustration isn't modified).

Then, below the illustration I place the same vector-based numbers in one column and the description of the feature in the next column. Then when all of the callouts are identified, I'll usually take that two-column table and divide it into either a four-column table or a six-column table with the numbers sorted numerically in the first column, an equal amount of numbers sorted numerically in the third column, and (if necessary) an equal amount of numbers sorted numerically in the fifth column. I do this to reduce the amount of vertical space the callout identification consumes. So column 1 might contain the numbers 1, 2, and 3, with the appropriate identifiers in column 2, column 3 might contain the numbers 4, 5, and 6, with the appropriate identifiers in column 4, and finally column 5 might contain the numbers 7, 8, and 9, with the appropriate identifiers in column 6. Murphy's law seems to dictate that I'll always end up with the number of callouts being a prime number so I can't make my columns balance.

I don't use an autonumbered style for a couple reasons...

* I want the numbers in the table to look exactly the same as the
numbers associated with the illustration.
* I don't want the possibility of the numbering getting hosed.

I also use tables because sometimes the description can be lengthy and if they are, it's difficult to create styled side-by-side paragraphs. I can always make it look professional with a minimum amount of effort.

Best Regards,

Mike
--
Mike Starr, Writer
Technical Writer - Online Help Developer - WordPress Websites
Graphic Designer - Desktop Publisher - Custom Microsoft Word templates
(262) 694-1028 - mike -at- writestarr -dot- com - http://www.writestarr.com
President - Working Writers of Wisconsin http://www.workingwriters.org/

On 5/11/2015 9:40 PM, Gene Kim-Eng wrote:

Still doesn't change the fact that these items have no X-Y relationship with each other and no reason to be in a table rather than a list. The list should be a simple one-column read and the callouts that reference it should have a standardized layout (for example, clockwise around the object).

If you're going to use tables, you should have the numbers in column 1 and the item names in column 2. There's a reason why Word table-to-text produces the table layout it does from a numbered list.

If your current documents have a disorganized mish-mash of bad layouts, don't just pick one of the bad layouts to standardize on. Do new documents sensibly for the benefit of the reader and not just because it's easier to do and then fix your old ones as time and schedule permits - or at least make it a policy to correct the figure callouts and lists with future updates.

Gene Kim-Eng


On 5/11/2015 7:05 PM, William Sherman wrote:
I didn't think those would come out. This is closer to how they were supposed to look in the other.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Adobe TCS 5: Get the Best of both worlds: modern publishing and best in class XML \ DITA authoring | http://adobe.ly/scpwfT

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as mike -at- writestarr -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Adobe TCS 5: Get the Best of both worlds: modern publishing and best in class XML \ DITA authoring | http://adobe.ly/scpwfT

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Not content with the definitions for "content": From: Tony Chung
Table layout - Which way is best?: From: William Sherman
Re: Table layout - Which way is best?: From: Robert Lauriston
Re: Table layout - Which way is best?: From: Peter Neilson
Re: Table layout - Which way is best?: From: William Sherman
Re: Table layout - Which way is best?: From: William Sherman
Re: Table layout - Which way is best?: From: Gene Kim-Eng

Previous by Author: Re: Table layout - Which way is best?
Next by Author: Re: Freelancing and EIN
Previous by Thread: Re: Table layout - Which way is best?
Next by Thread: Re: Table layout - Which way is best?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads