Re: Must documentation always follow the UI?

Subject: Re: Must documentation always follow the UI?
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 23 Sep 2015 12:29:22 -0700

In that specific situation, I'd say it might be easier to copy the
order on the screen, since there are so few items.

Around 8-10 items it starts to get easier to alphabetize instead.


On Wed, Sep 23, 2015 at 12:18 PM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com> wrote:
>
> Hello, Whirlers,
>
> How important is it that documentation exactly follow the interface?
>
> Hypothetical question: On the landing page of an application, functions are laid out in non-alphabetical order. There doesn't *seem* to be a functional reason for laying it out the way it is. Maybe they were developed in this order. Let's say it looks a bit random. Something like this:
>
>
> * Crotons
>
> * Abercrombie
>
> * Donuts
>
> * Fish
>
> * Ectoplasm
>
> * Birds
>
> * Guppies
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Learn more about Adobe Technical Communication Suite (2015 Release) | http://bit.ly/1FR7zNW

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

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:
Must documentation always follow the UI?: From: Cardimon, Craig

Previous by Author: Re: Field testing manuals
Next by Author: Re: Must documentation always follow the UI?
Previous by Thread: Re: Must documentation always follow the UI?
Next by Thread: Re: Must documentation always follow the UI?


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


Sponsored Ads