Off topic - three general documentation questions

[Art Campbell]

Ian,
In general, from a professional tech writer viewpoint, I think the
first two ideas suck, but to go a little further, you didn't really
provide enough info:
 * what is the goal of the redo?
 * what standard or style guide are you following that presents these
suggestions, or which are you going to follow?
 * what audience do you write to
 * what kind of guides are you producing? Software / hardware,
installation, administration, user, something else?

As for the third idea, why have blank pages in a PDF at all? If it's
so people can print a book traditional fashion... that may be the real
question -- if that's useful, or required, or something else. In any
case, I'd simply eliminate the blanks before I labeled them unless
they are required AND a label is required by a standard.

Cheers,
Art

Art Campbell
               art.campbell at gmail.com
  "... In my opinion, there's nothing in this world beats a '52
Vincent and a redheaded girl." -- Richard Thompson
                                                      No disclaimers apply.
                                                               DoD 358



On Fri, Mar 13, 2009 at 5:45 AM, Saunders, Ian <ISaunders at syntellect.com> wrote:
> Please forgive this off-topic query, but I have nowhere else to turn for help.
>
> My team are reviewing the Frame templates we use for producing PDF files. It has been suggested that we:
>
> *         Do not use chapter numbers/appendix letters
>
> *         Begin main index entries with a capital letter
>
> *         Put a logo (or message) on blank pages to show that they are not blank in error.
>
> We have reached an impasse...
>
> I would be extremely grateful to anyone who can supply their take on the relevant "industry standards" or maybe even point me at a definitive statement.
>
> Many thanks!
>
> Ian Saunders
> Syntellect Inc
>
> _______________________________________________
>
>
> You are currently subscribed to Framers as art.campbell at gmail.com.
>
> Send list messages to framers at lists.frameusers.com.
>
> To unsubscribe send a blank email to
> framers-unsubscribe at lists.frameusers.com
> or visit http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com
>
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.
>