Hi,
On Thu, Jan 15, 2015 at 2:04 AM, Bill Shannon <bill.shannon_at_oracle.com> wrote:
> We don't know of a good cross-platform wysiwyg tool that produces high
> quality html and can handle documents that are hundreds of pages long,
> importing our existing formats.
I personally haven't used it, and it certainly isn't wysiwyg and it
probably won't have converters available for all existing formats, but
at Devoxx's EG meetup two years ago I think most people mentioned
AsciiDoc as the preferred tool.
At least for new JSRs (MVC, Security, etc) it might not hurt to see if
we can agree on a common tool?
Kind regards,
Arjan
>
> If we didn't all have something else to do, we might consider this, but so
> far it hasn't gotten close to the top of the priority list.
>
> I really wish we could find a solution to this, but so far we haven't.
>
> Antoine Sabot-Durand wrote on 01/07/15 05:45:
>
> If we'd go that way, perhaps we should proceed step by step. We could start
> by asking each spec to produce an HTML version of their doc with a browsable
> TOC. Having the same source format seems a bit harder and more internal
> needs than benefit for our users.
>
>
> Le 7 janv. 2015 à 11:59, arjan tijms <arjan.tijms_at_gmail.com> a écrit :
>
> Hi,
>
> On Wed, Jan 7, 2015 at 11:45 AM, Antoine Sabot-Durand
> <antoine_at_sabot-durand.net> wrote:
>>
>> [...]
>>
>> For instance today with CDI doc if someone ask a question about producer
>> method I can easily answer by sending a link to the doc like this :
>> http://docs.jboss.org/cdi/spec/1.2/cdi-spec.html#producer_method.
>>
>> IMO It would lower learning curve and ease adoption to have something
>> similar for each other spec.
>>
>> What do you think ?
>
>
> Would be great indeed. If I remember correctly this was discussed during
> various EG meetups (e.g. I think at Devoxx 2 years ago). Part of the problem
> was that the spec text is now in various formats, and who's going to convert
> that to something else? Mojarra for instance uses the FrameMaker format now.
>
> Kind regards,
> Arjan Tijms
>
>
>
>>
>>
>>
>> Antoine Sabot-Durand
>> ———————————————
>> Twitter : @antoine_sd
>> CDI co-spec lead & eco-system development
>> Agorava tech lead
>>
>
>
>