directory-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Guillaume Nodet <gno...@gmail.com>
Subject Re: Writing docos : howto ?
Date Tue, 01 Jun 2010 18:13:05 GMT
I guess the main point is that this confluence markup snippets do not
reside in confluence, but in subversion.
So confluence isn't involved at all.

On Tue, Jun 1, 2010 at 20:03, Guillaume Nodet <gnodet@gmail.com> wrote:
> I was not suggesting to use confluence, rather just using the
> confluence syntax (which is imho easier to use) to generate docbook
> xml.  The plugin converts snippets of confluence markup into docbook
> xml.
>
> On Tue, Jun 1, 2010 at 19:32, Emmanuel Lécharny <elecharny@apache.org> wrote:
>> On 6/1/10 7:19 PM, Guillaume Nodet wrote:
>>>
>>> FWIW, we're about to do the same in servicemix and we're working on a
>>> maven plugin to generate docbook xml from confluence wiki syntax.
>>> This is way easier than xml docbook to write and patch imho.
>>> See the following for the maven plugin:
>>>
>>>  http://svn.apache.org/repos/asf/servicemix/maven-plugins/docs-maven-plugin/trunk/
>>> and an exmaple:
>>>
>>>  http://svn.apache.org/repos/asf/servicemix/documentation/trunk/docs/jbi/src/confluence/servicemix-bean.wiki
>>>
>>
>> We just find Confluence a bit too convoluted to use when it comes to doco.
>> Not only links are rather complicated to manage (back and forwards links),
>> but it's also impossible to generate PDF from confluence AFAIK.
>>
>> We should rather use confluence for the FAS, changing doco, and dev infos.
>>
>> --
>> Regards,
>> Cordialement,
>> Emmanuel Lécharny
>> www.nextury.com
>>
>>
>>
>
>
>
> --
> Cheers,
> Guillaume Nodet
> ------------------------
> Blog: http://gnodet.blogspot.com/
> ------------------------
> Open Source SOA
> http://fusesource.com
>



-- 
Cheers,
Guillaume Nodet
------------------------
Blog: http://gnodet.blogspot.com/
------------------------
Open Source SOA
http://fusesource.com

Mime
View raw message