TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: What is the section in a publication... From:Keith Hood <klhra -at- yahoo -dot- com> To:techwr-l -at- lists -dot- techwr-l -dot- com, salt -dot- morton -at- gmail -dot- com Date:Tue, 27 Jan 2009 10:10:31 -0800 (PST)
I always put in a section titled "About This Document" with various subsections. One of the subsections is "Typographical Conventions" where I explain things the reader may need to know about the fonts and layouts, like the differences between 'notes' and 'warnings.' One subjection gives "Graphical Conventions" where I explain things about the illustrations, like how callouts on the screen captures are related to explanatory notes.
I wouldn't use the word "colophon." Some people will confuse it with anatomical terms and it could become the butt of bad jokes. :-)
--- On Tue, 1/27/09, Chris Morton <salt -dot- morton -at- gmail -dot- com> wrote:
From: Chris Morton <salt -dot- morton -at- gmail -dot- com>
Subject: Re: What is the section in a publication...
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tuesday, January 27, 2009, 1:03 PM
I've just used a *Conventions* headeer in the past. > Chris
On Tue, Jan 27, 2009 at 10:01 AM, Geoff Hart <ghart -at- videotron -dot- ca> wrote:
> John Posada wondered: <<... that describes the font, layout
> application, and everything about how the publication is designed and
> formatted.>>
>
> The "colophon"? That's most often interpreted to mean the page with
> publisher information, but it's also used for production details.
>
> --------------------------------------------------------
> Geoff Hart (www.geoff-hart.com)
> ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
> --------------------------------------------------------
> ***Now available*** _Effective onscreen editing_
> (http://www.geoff-hart.com/books/eoe/onscreen-book.htm)
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
> solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
> HTML and publish to the Web, Help systems or printed manuals.
>http://www.doctohelp.com
>
> Help & Manual 5: The complete help authoring tool for individual
> authors and teams. Professional power, intuitive interface. Write
> once, publish to 8 formats. Multi-user authoring and version control!
>http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as salt -dot- morton -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/salt.morton%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as klhra -at- yahoo -dot- com -dot-
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
