[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: XML documentation projects

• To: "Pavel A. Sher" <pavel@a...>
• Subject: Re: XML documentation projects
• From: Mitch Amiano <mamiano@n...>
• Date: Sat, 19 Apr 2003 10:01:32 -0400
• Cc: xml-dev@l...
• In-reply-to: <145333397450.20030418155520@a...>
• Organization: Software Adjuvant
• References: <145333397450.20030418155520@a...>
• Reply-to: mamiano@n...
• User-agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.3) Gecko/20030312

IMO, it depends upon what kind of processes to which you are applying 
XML. If you are mainly applying toward technical documentation and 
you already have a content management system (CMS) for your legacy 
formats, that CMS should be a consideration. 

If on the other hand you are looking at XML because you are going to
use it as part of the source code base for an application, then the 
source code control system should be considered. (If you aren't 
using a source code control system when writing applications, you 
should be.)

A for-instance: when my client, a test automation team, decided to 
document test procedures with XML, they integrated the new schemas
and scripts into an existing ClearCase source control system, and 
managed their XML in it. 

- Mitch

Pavel A. Sher wrote:
> Hello,
> 
> Suppose, I am starting a new project containing xml documentation.
> That xml documentation will be processed by some tool which is able to
> generate documentation from source xml files in various formats. Is
> there any standard or preferable organization of catalogs for xml 
> documentation projects?
> 
> For example, are there any thoughts what is a good place for source
> xml files, dtd, xsd files, images and various binary files?
> 
> 

• References:
  • XML documentation projects
    • From: "Pavel A. Sher" <pavel@a...>

• Prev by Date: Re: What is XML's appropriate place in an office suite?
• Next by Date: Re: What is XML's appropriate place in an office suite?
• Previous by thread: Re: XML documentation projects
• Next by thread: What is XML's appropriate place in an office suite?
• Index(es):
  • Date
  • Thread