RE: Best practice for technical documentation page length on a website?

Subject: RE: Best practice for technical documentation page length on a website?
From: "Gordon McLean" <Gordon -dot- McLean -at- GrahamTechnology -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 26 Jul 2007 16:53:52 +0100

Spooky, we just had this very conversation today.

My understanding is that the "users don't like to scroll" thinking is now
outdated. It should be (have been) stated as "users don't like to scroll too
much".

One solution would be to use inter-page links, and present a short list of
links at the top of the long page, allowing users to click to jump to the
specific location in a long page.

In your example though, I'd question the reasoning as to why you have six
separate pages in the first place, there might be a very good reason for
that.

HTH

Gordon


-----Original Message-----
Subject: Best practice for technical documentation page length on a website?


Within the original CHM files, the tendency was to have a fairly 'deep'
table of contents and often lots of relatively short pages within each
section. This same structure was transferred to the website.

Understandably, some people are complaining that it takes too long to drill
down and find information, and I agree that many of the sections could be
combined into a single page (many pages are no more than a paragraph long).
I'm comfortable with this, but in the back of my mind I have the words of a
web developer ringing in my ears from years ago - "web users don't like
scrolling, pages should be short and snappy".

Now, this was some time ago, and I suspect that attitudes have changed,
particularly with the advent of wikis, etc. I also feel that there is a
significant difference between writing "short, snappy" pages for a standard
website, and writing pages that contain technical documentation.

I will obviously seek the views of people who use the documentation before I
make major changes, but I'm just wondering if anyone is aware of a 'best
practice' for this. What would you do if you had six separate pages of
technical documentation that could (logically) be combined into one, long
web page that would require multiple scrolls to read?


____________________________________________________________________________________________________
This email (and any attachments) is private and confidential, and is intended solely for the
addressee. If you have received this communication in error please remove it and inform us via
telephone or email. Although we take all possible steps to ensure mail and attachments
are free from malicious content, malware and viruses, we cannot accept any responsibility
whatsoever for any changes to content outwith our administrative bounds. The views represented
within this mail are solely the view of the author and do not reflect the views of the organisation
as a whole.
____________________________________________________________________________________________________
Graham Technology plc
Registered in Scotland company no. SC143434
Registered Office India of Inchinnan, Renfrewshire, Scotland PA4 9LH

http://www.grahamtechnology.com
____________________________________________________________________________________________________

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

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.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.


References:
Best practice for technical documentation page length on a website?: From: procrastiwriter

Previous by Author: RE: The coming predominance of user experience andtechnicalcommunications
Next by Author: RE: The coming predominance of user experienceandtechnicalcommunications
Previous by Thread: Best practice for technical documentation page length on a website?
Next by Thread: Re: Best practice for technical documentation page length on a website?


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


Sponsored Ads