Re: Naming Files and Folders

Subject: Re: Naming Files and Folders
From: "Bob Doyle" <bobdoyle -at- skybuilders -dot- com>
To: "Ronquillo, Michael" <mronquillo -at- equitrac -dot- com>
Date: Thu, 20 Mar 2008 23:26:09 -0400

Hi Michael,

Here are some suggestions taken from the DITA.XML.org website.
http://dita.xml.org/book/file-and-folder-naming.

Some rules for content that will be published to a website

Use underscore to separate all-lower-case words in filenames and in folder
names. Although the underscores disappear when shown as a hyperlink, this is
still quite readable. (Amazon now links to its books this way. And the BBC
follows this convention for their thousands of websites.)

Arrange folders to match the navigation scheme in a web site. Top-level
landing pages should be in the main folder, section pages in folders with
section name, etc. Then the path names for hyperlinks have a 1-to-1 mapping
with the website information architecture.

Users have a comfortable feeling that they can know where they are based on
the path name.

Cheers.

Bob
--
Bob Doyle
Editor In Chief, CMS Review - http://www.cmsreview.com
Founder, DITA Users - http://www.ditausers.org
Former Technology Advisor, CM Pros -
http://www.cmprofessionals.org/membership/cm-profiles/bob-doyle
Contributing Editor, EContent Magazine -
http://www.econtentmag.com/Articles/ArticleIndex.aspx?ContextSubtypeID=71
President and CEO, skyBuilders - http://www.skybuilders.com
77 Huron Avenue
Cambridge, MA 02138
Tel: +1 617-876-5676 Skype:bobdoyle
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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:
Naming Files and Folders: From: Ronquillo, Michael

Previous by Author: RE: Dori
Next by Author: RE: 'log in to' or 'log into'?
Previous by Thread: RE: Naming Files and Folders
Next by Thread: Re: Naming Files and Folders


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


Sponsored Ads