[aerogear-dev] Versioning Documentation

Matthias Wessendorf matzew at apache.org
Wed May 27 04:16:58 EDT 2015


What's the JIRA ? :)

On Wed, May 27, 2015 at 8:31 AM, Corinne Krych <corinnekrych at gmail.com>
wrote:

> +1
> specially for a guide
> it would be nice to match the released version.
>
> On 26 May 2015 at 14:53, Luke Holmquist <lholmqui at redhat.com> wrote:
>
>> this would be nice.
>>
>> On Tue, May 26, 2015 at 7:58 AM, Lukáš Fryč <lukas at fryc.eu> wrote:
>>
>>> Hey guys,
>>>
>>> Tadeas started a discussion about versioning documentation in the thread
>>> [1],
>>>
>>>
>>> and I must agree - it is a good idea to version documentation (and
>>> possibly also guides),
>>>
>>> especially since our UPS Console now points from the UI to the
>>> documentation -
>>> that is a great feature but I'm worried about maintanance of that
>>> solution, a documentation tend to change in time, with links no longer
>>> being valid.
>>>
>>>
>>> Lot of projects publish generated documentation separately, hosting it
>>> e.g. on docs.jboss.org (see [2] for a sample).
>>>
>>> I'd suggest to version both, API documentation and guides on a separated
>>> server.
>>> Perhaps we could version whole site?
>>>
>>>
>>>
>>> WDYT?
>>>
>>>
>>> Cheers,
>>>
>>> ~ Lukas
>>>
>>> [1]
>>> http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-UnifiedPush-Server-1-1-0-beta-1-tp11665p11672.html
>>> [2] http://docs.jboss.org/richfaces/
>>>
>>> _______________________________________________
>>> aerogear-dev mailing list
>>> aerogear-dev at lists.jboss.org
>>> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>>>
>>
>>
>> _______________________________________________
>> aerogear-dev mailing list
>> aerogear-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>>
>
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>



-- 
Matthias Wessendorf

blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20150527/54163069/attachment-0001.html 


More information about the aerogear-dev mailing list