[aerogear-dev] Versioning Documentation

[Corinne Krych]

We can have an site umbrella versionning but it would be good to know let's
say for example UPS 1.1.0 guide is in aerogear.org 2.6.0

wdyt?
++
Corinne

On 27 May 2015 at 16:50, Lukáš Fryč <lukas.fryc at gmail.com> wrote:

> I've created this issue: https://issues.jboss.org/browse/AEROGEAR-1686
>
> One problem we will have to overcome is that we have many different
> modules versioned differently, so we can't simply version whole site as it
> is. This will need some cleverish idea :-)
>
> st 27. 5. 2015 v 16:08 odesílatel Bruno Oliveira <bruno at abstractj.org>
> napsal:
>
>> +1 go ahead
>>
>> On Tue, May 26, 2015 at 8: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
>>>
>>
>>
>>
>> --
>>
>> --
>> "The measure of a man is what he does with power" - Plato
>> -
>> @abstractj
>> -
>> Volenti Nihil Difficile
>>  _______________________________________________
>> 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20150528/e914cffa/attachment.html