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... [2] http://docs.jboss.org/richfaces/ _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

this would be nice. On Tue, May 26, 2015 at 7:58 AM, Lukáš Fryč <lukas(a)fryc.eu&gt; 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... > [2] http://docs.jboss.org/richfaces/ > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev > _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

What's the JIRA ? :)

On Wed, May 27, 2015 at 8:31 AM, Corinne Krych <corinnekrych(a)gmail.com&gt; 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(a)redhat.com&gt; wrote: > >> this would be nice. >> >> On Tue, May 26, 2015 at 7:58 AM, Lukáš Fryč <lukas(a)fryc.eu&gt; 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... >>> [2] http://docs.jboss.org/richfaces/ >>> >>> _______________________________________________ >>> aerogear-dev mailing list >>> aerogear-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/aerogear-dev >>> >> >> >> _______________________________________________ >> aerogear-dev mailing list >> aerogear-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/aerogear-dev >> > > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)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 _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

+1 go ahead On Tue, May 26, 2015 at 8:58 AM, Lukáš Fryč <lukas(a)fryc.eu&gt; 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... > [2] http://docs.jboss.org/richfaces/ > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)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(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

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(a)gmail.com&gt; 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(a)abstractj.org&gt; > napsal: > >> +1 go ahead >> >> On Tue, May 26, 2015 at 8:58 AM, Lukáš Fryč <lukas(a)fryc.eu&gt; 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... >>> [2] http://docs.jboss.org/richfaces/ >>> >>> _______________________________________________ >>> aerogear-dev mailing list >>> aerogear-dev(a)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(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/aerogear-dev > > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev > _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev