I feel your pain...
We've discussed this numerous times internally.
Most people like the tools they're using today to produce specs, and not
everyone is using the same tool.
Not all of the tools produce html, or produce it easily, or produce good quality
html.
Converting people and documents to a new tool chain is hard. Really hard.
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.
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
>> <mailto: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 <mailto: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
>>
>>
>