[aerogear-dev] Versioning Documentation

[Lukáš Fryč]

Yes,

That would work if we have some kind of mapping.

I guess we could find lot of information from commit history, maybe having
tags specific to each versioned component and then jekyll plugin that can
make sense from it.
On May 28, 2015 8:14 AM, "Corinne Krych" <corinnekrych at gmail.com> wrote:

> 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
>>
>
>
> _______________________________________________
> 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/ef09ad80/attachment-0001.html