Re: Object-Oriented Development and Documentation

["Bruce H. Johnson" <corpknow -at- EARTHLINK -dot- NET>]

On 2 Jul, Michael Wing wrote:

Matthew and interested in COM documentation;

>I, too, have found that many of my writing tasks are being replaced with
automation model analysis, reusable help, context-sensitivity, and so
forth.  So much so, that I would guess that writing consumes only 20% of
my time.  For example, the products that I document (I write
programmer's reference material) are created in applets.  Applets are
reused between applications.  For example, a 3d mechanical design
package and a cartographic package may both use the complete text
applet; however, one of the packages may only use a portion of the
geometry applet.  This presents some logistic documentation problems as
follows:

<lots more on designing the modular Help system>

>Mike Wing

>_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/
>_/
>_/   Michael Wing
>_/   Principal Technical Writer
>_/   Jupiter Customization and Educational Services
>_/   Intergraph Corporation
>_/   730-7250
>_/   mjwing -at- ingr -dot- com
>_/


One of the best design methodologies I've run across in a long time.
Very well done!


--
Bruce H. Johnson
Corporate Knowledge, Inc. -- Your knowledge transfer specialists.
corpknow -at- earthlink -dot- net       Los Angeles, California
#include <disclaimer.h>
http://www.business1.com/cki/

                  TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot-  Send administrative commands
         ALL other questions or problems concerning the list
       should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-