Re: [Springframework-developer] reference documentation

[Colin S. <col...@ex...>]

We're not putting out an incredibly complicated manual. All things being 
equal, if Confluence can produce the same level of output for html and 
pdf, I think it'd be preferred over the existing setup. My feeling is 
people would be more likely to work on the docs if they can do it in an 
interactive fashion, and bite of little chunks at a time, as opposed to 
having to pull out the source, fire up something that can make docbook 
editing half decent (aka XmlMind), and then check stuff back in.

The real question is whether it would be worth doing a move now that the 
existing setup is working though... I would suggest it's a no brainer to 
move the web site to Confluence if Atlassian is willing to act on their 
offer though, and take it from there, i.e. think about the main manual 
later.


sam...@ma... wrote:

>Wikis to not technical documentation make. What I mean by that is that Wikis are
>excellent places for discussion and storings ideas etc. My recommendation is to
>use the Wiki and a database of information for the project as a whole, and
>perhaps even for online tutorials/examples. The technical documentation (the
>docbook one) should remain as it is, but may well take aspects from the Wiki
>(confluence). Confluence seems good enough to actually host the whole Spring
>website if required.
>
>sam
>
>Quoting sk...@fe...:
>
>  
>
>>From what I can tell Confluence can export to pdf but I see no mention of
>>docbook. I personally like the ease of wikis and webdav like products but I
>>don't think they are sufficient for real technical documentation that needs
>>to be exported to many different formats. I've always done the "stream of
>>consciousness" documentation on a day by day basis in a wiki then
>>cut'n'pasted it into something else in the end for proper editing.
>>
>>So this is off topic a bit but as it involves Spring documentation I would
>>tend to favor anything that keeps the docs in a docbook or superset of
>>docbook like format. Now if confluence was a web based docbook editor or
>>could export to something that I could then convert automatically to any
>>number of formats I'd be sold right now.
>>
>>Sean Kroah
>>FedEx Ground
>>(412) 859-5130
>>
>>sk...@fe...
>>
>>
>>
>>
>>
>>-------------------------------------------------------
>>This SF.Net email is sponsored by: IBM Linux Tutorials
>>Free Linux tutorial presented by Daniel Robbins, President and CEO of
>>GenToo technologies. Learn everything from fundamentals to system
>>administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click
>>    
>>