RE: [Springframework-developer] Documentation

[Mark P. <mar...@co...>]

What system does Hibernate use?

If we were going to use maven just for the docs, on the surface forrest
looks like a more appropriate document centric solution.

- Mark


-----Original Message-----
From: spr...@li...
[mailto:spr...@li...] On Behalf
Of Colin Sampaleanu
Sent: Tuesday, October 21, 2003 9:39 AM
To: al...@jt...
Cc: 'Rod Johnson'; 'Spring Developers'
Subject: Re: [Springframework-developer] Documentation


Aside from doing something homebrew, the other choice for documentation 
is probably Forrest, which I've never used:
  http://xml.apache.org/forrest/


Alef Arendsen (JTeam) wrote:

>Well, I don't really like Maven for _building_ software. For putting 
>out documentation though, I think it's quite nice...
>
>Alef
>
>
>  
>
>>-----Oorspronkelijk bericht-----
>>Van: spr...@li...
>>[mailto:spr...@li...]
>> Namens Colin Sampaleanu
>>Verzonden: Thursday, October 16, 2003 7:16 PM
>>Aan: Rod Johnson
>>CC: 'Spring Developers'
>>Onderwerp: Re: [Springframework-developer] Documentation
>>
>>
>>I actually have a lot of experience with Maven, having
>>tinkered with it 
>>a bunch over the last year (unfortunately, the multiproject support, 
>>where I think Maven becomes the most useful (along with the 
>>docs) to me, 
>>is still broken in some respects (property and repository 
>>overrides, for 
>>one), but that would not have an effect on Spring.
>>
>>If there is consensus on this, I am willing to put in some time to
>>finish this up, as necessary.
>>
>>
>>Rod Johnson wrote:
>>
>>    
>>
>>>I believe Luke Tayler did a Maven build script which works. So we
>>>certainly have a starting point.
>>>
>>>Rod
>>>
>>>----- Original Message -----
>>>From: "Colin Sampaleanu" <col...@ex...>
>>>To: "'Spring Developers'"
>>>      
>>>
>><spr...@li...>
>>    
>>
>>>Sent: Thursday, October 16, 2003 5:17 PM
>>>Subject: Re: [Springframework-developer] Documentation
>>>
>>>
>>> 
>>>
>>>>From my point of view, while of course there is a general need for
>>>      
>>>
>>>>more documentation and samples, what would also be of some
>>>>        
>>>>
>>use is some
>>    
>>
>>>>general infrastructure for producing consistent and relatively
>>>>professional looking docs and a website. I am not a big fan 
>>>>        
>>>>
>>of Maven
>>    
>>
>>>>generated websites with nothing in them, but on the other hand, if
>>>>people are willing to write documentation, Maven (and other 
>>>>alternatives like Forrest) make it pretty easy to put out 
>>>>documentation without having to worry too much about the look and 
>>>>feel, linking it into the site, etc.
>>>>
>>>>W/regards to the possibility of using Maven, one option would be to
>>>>use it just for doc generation, if doing the entire build 
>>>>        
>>>>
>>with it is
>>    
>>
>>>>too onerous. This approach has been used by other projects...
>>>>
>>>>Regards,
>>>>Colin
>>>>
>>>>Alef Arendsen (JTeam) wrote:
>>>>
>>>>   
>>>>
>>>>        
>>>>
>>>>>Hi all,
>>>>>
>>>>>Since I am busy closing 2002's financial year (doing all the
>>>>>accounting and stuff; I never should have started a company :), I 
>>>>>desperately need some things I can do when I'm totally sick of all 
>>>>>those numbers and spreadsheets. No internal projects here, 
>>>>>          
>>>>>
>>so I was
>>    
>>
>>>>>wondering if there already is a plan for how to improve our
>>>>>documentation base or if there are if there other important things 
>>>>>that need to be addressed.
>>>>>
>>>>>Juergen, other people, any thoughts?
>>>>>
>>>>>Thanx,
>>>>>
>>>>>Alef
>>>>>          
>>>>>




-------------------------------------------------------
This SF.net email is sponsored by OSDN developer relations Here's your
chance to show off your extensive product knowledge We want to know what
you know. Tell us and you have a chance to win $100
http://www.zoomerang.com/survey.zgi?HRPT1X3RYQNC5V4MLNSV3E54
_______________________________________________
Springframework-developer mailing list
Spr...@li...
https://lists.sourceforge.net/lists/listinfo/springframework-developer