Re: [OT] Documenting projects

2003-04-06 Thread Dan Allen
[EMAIL PROTECTED] ([EMAIL PROTECTED]) wrote: As far as requirements, you should pick up a Rational Unified Process book and look at designing use-cases with Word. ...or KWord or swriter (OpenOffice/StarOffice) Design, you can use visio ArgoUML or Dia Sorry, just had to plug for the open

Re: [OT] Documenting projects

2003-04-05 Thread Jose Gonzalez Gomez
Jason, Thanks for your response. I'am already using Poseidon for the UML part, and after searching and reading a while I think I'll adopt DocBook. What software do you use to author DocBook documents? A plain XML editor with DTD validation or do you use anything else? Regards Jose

Re: [OT] Documenting projects

2003-04-05 Thread Jose Gonzalez Gomez
Mick, Thanks for your response, but I cannot take that approach because of control version. I think there are some products that lets you control versioning of Word documents but they are not free/open source. About free tools for UML, there are a few, in case you are interested. I'm

Re: [OT] Documenting projects

2003-04-05 Thread Jason Lea
Jose Gonzalez Gomez wrote: Jason, Thanks for your response. I'am already using Poseidon for the UML part, and after searching and reading a while I think I'll adopt DocBook. What software do you use to author DocBook documents? A plain XML editor with DTD validation or do you use

Re: [OT] Documenting projects

2003-04-05 Thread Paul Thomas
On 04/04/2003 13:19 Jose Gonzalez Gomez wrote: Sorry, I wasn't explicit... I was thinking about other kind of documentation, like requirements capture with use cases, analysis and design with UML, etc There's an open source diagramming program called dia which does UML and might be worth

[OT] Documenting projects

2003-04-04 Thread Jose Gonzalez Gomez
Hi there, I want to document a project using something free, with text format so I can include it in cvs (I know I can include binaries, but you lose all the information about changes), and I would like to be able to integrate it with maven. The options so far are html (or xhtml),

RE: [OT] Documenting projects

2003-04-04 Thread Mick . Knutson
You always have javadocs and those can be generated automatically with ANT build scripts. -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Friday, April 04, 2003 1:46 PM To: Struts Users Mailing List Subject: [OT] Documenting projects Hi there, I

Re: [OT] Documenting projects

2003-04-04 Thread Jose Gonzalez Gomez
- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Friday, April 04, 2003 1:46 PM To: Struts Users Mailing List Subject: [OT] Documenting projects Hi there, I want to document a project using something free, with text format so I can include it in cvs (I know I can include

RE: [OT] Documenting projects

2003-04-04 Thread Mick . Knutson
Not really sure. -Original Message- From: Jose Gonzalez Gomez [mailto:[EMAIL PROTECTED] Sent: Friday, April 04, 2003 2:19 PM To: Struts Users Mailing List Subject: Re: [OT] Documenting projects Sorry, I wasn't explicit... I was thinking about other kind of documentation, like

Re: [OT] Documenting projects

2003-04-04 Thread Jason Lea
Jose Gonzalez Gomez wrote: Sorry, I wasn't explicit... I was thinking about other kind of documentation, like requirements capture with use cases, analysis and design with UML, etc We used DocBook with some extensions for creating Use Cases. So that we could create PDFs, HTML etc and some