[aerogear-dev] Versioning Documentation

Corinne Krych corinnekrych at gmail.com
Wed May 27 02:31:16 EDT 2015


+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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20150527/4122faa7/attachment.html 


More information about the aerogear-dev mailing list