Re: Question concerning product customization and documentation

Subject: Re: Question concerning product customization and documentation
From: David Castro <thetechwriter -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 22 Jan 2003 09:54:46 -0800 (PST)


> Do you externalize parts of your product for customer modification, i.e.
> field names, object names, etc.?
>
> so potentially you could have 100 different customers calling a widget, a 100

> different names.
>
> If you do, how do you handle keeping the documentation straight with the
> customer modifications?

Actually, one of my fellow presenters at WinWriters in February of last year
(and then again later in Boston in August), Chip Jones, presented on how
Ceridian does *exactly* this. They extract the widget names into a database,
and then allow users to name them what they want to name them. The
corresponding locations in the documentation change accordingly. He even
provided the ASP source code for how they did it, in the proceedings!
(Unfortunately, WinWriters doesn't make the proceedings available to people who
didn't attend the conference.)

I probably shouldn't post his email address on the list, since I don't know if
he is a subscriber (I can't recall seeing any of his posts, if he is), but if
you email me, I will forward any questions you may have for him on to him.

I also have experience with including database content in documentation, so if
you have any questions for me, please feel free to ask away. I love talking
about this stuff! :-) I also have a web site that teaches how to do it (the
information is even specifically written for technical writers!) at
http://jsp.davidcastro.com.

-David Castro
email -at- davidcastro -dot- com
http://jsp.davidcastro.com


__________________________________________________
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Help Authoring Seminar 2003, coming soon to a city near you! Attend this
educational and affordable one-day seminar covering existing and emerging
trends in Help authoring technology. See http://www.ehelp.com/techwr-l2.

A new book on Single Sourcing has been released by William Andrew
Publishing: _Single Sourcing: Building Modular Documentation_
is now available at: http://www.williamandrew.com/titles/1491.html.

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Previous by Author: Speaking of resumes....
Next by Author: Re: Planning and Designing a Website
Previous by Thread: RE: Question concerning product customization and documentation
Next by Thread: RE: Question concerning product customization and documentation


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


Sponsored Ads