[Zope] RE: [Zope-dev] Documentation Tool Requirements

Michel Pelletier michel@digicool.com
Thu, 19 Aug 1999 13:50:18 -0400


I think XML format for all docs is a requirement (up to debate).

This way Zope can be used to manage the content using XML Documents, and
the passive data can be 'activated' very easily.

Also, our current Docs are written in framemaker, which (with the $2K
addon) will output SGML and XML.

-Michel

> -----Original Message-----
> From: Stephan Richter [mailto:SRichter@ixl.com]
> Sent: Thursday, August 19, 1999 12:14 PM
> To: zope@zope.org; zope-dev@zope.org
> Subject: [Zope-dev] Documentation Tool Requirements
> 
> 
> hey Zopesters,
> 
> I originally posted this message to the ZDP list, but I 
> thought some of you
> guys may have some great input too. 
> 
> So, here you go. What I am looking for are requirements like features,
> usability, workflow, user levels and many other things that 
> you would like to
> see in the new FAQ, Tutorials, How-To's and Reference Manual. 
> The first two main tools will be FAQ and the Reference 
> Manual. These will be
> implemented first.
> Here is the format (XML) you should send the requirements in:
> <category title="title">
>       <abstract>
>             Structured Text describing the category (not 
> neccessary if the
>             category already exists.
>       </abstract>
> 
>       <entries>
>               <entry title="title of entry">
>                   <status>Requirement captured</status> 
>                   <rating>1-10</rating>
>                   <name>Your name</name>
>                   <abstract>
>                           Please describe your requirement in 
> structured text. I did not
>                           write renders for html tags. 
>                   </abstract>
>               </entry>
>         </entries>
> 
> </category>
> 
> The responses I got so far you can see at:
> http://www.zope.org:18200/Members/srichter
> 
> PLEASE DO NOT SEND RESPONSES TO THE ENTIRE LIST SO WE DO 
> NOT FILL UP MAILBOXES.
> I will post the results every night. Please do not reply with 
> requirements on
> the mailing list in normal text format, since it will take me 
> forever to
> extract them and put them into the proper format. Let's see 
> how strong the
> community can be.
> 
> THANK YOU ALL FOR YOUR INPUT.
> 
> regards,
> stephan
> --
> Stephan Richter
> iXL - Software Designer and Engineer
> 
> _______________________________________________
> Zope-Dev maillist  -  Zope-Dev@zope.org
> http://www.zope.org/mailman/listinfo/zope-dev
> 
> (To receive general Zope announcements, see:
> http://www.zope.org/mailman/listinfo/zope-announce
> 
> For non-developer, user-level issues, 
> zope@zope.org, http://www.zope.org/mailman/listinfo/zope )
>