Is it not possible to just have a master/latest/head/snapshot version of the docs on the web page with the individual release too. I do think it it important to snapshot the documents at the individual point releases and have those available. But just a latest, fresh from git link would be nice.
Darren On Wed, Oct 9, 2013 at 7:11 PM, Ron Wheeler <rwhee...@artifact-software.com> wrote: > When the software was released with a number of reported bugs in the docs, > it was done with the understanding that the 4.2 docs would be prepared after > the release of the software. > > Ron > > > On 09/10/2013 4:34 PM, Daan Hoogland wrote: >> >> Great rant Carlos, >> >> You should get it to the dev list. Actually I'll add the dev list in >> now. It makes sense to update the docs also after a release, when bug >> in the docs are found these can easily be changed without a full >> release cycle of the code itself. >> >> regards, >> Daan >> >> On Wed, Oct 9, 2013 at 10:24 PM, Carlos Reategui <create...@gmail.com> >> wrote: >>> >>> It seems like the only way that docs ( >>> http://cloudstack.apache.org/docs/en-US/index.html) are updated is when a >>> release is done. Is it not possible to have these updated otherwise? >>> Waiting for the next patch release of the software so that the docs get >>> updated is causing problems with folks not being able to get CloudStack >>> installed properly and therefore gives them a bad impression of the >>> maturity of CloudStack. >>> >>> It makes no sense to me why there are multiple versions of documents for >>> each of the point releases (currently there is 4.0.0, 4.0.1, 4.0.2, >>> 4.1.0, >>> 4.1.1 and 4.0.2 docs) when the feature set has not changed within each of >>> these. I understand that the docs are built as part of the build and >>> release process but why does that have to impact the rate at which the >>> primary doc site is updated. Can't the patch releases simply update the >>> release notes? Personally I think there should be a single 4.x version >>> of >>> the docs (I would be ok with a 4.0, 4.1 and 4.2 versions too if major >>> features are going to be added to them). Maybe the doc site should have >>> wiki like capabilities so that it can be more easily maintained. >>> >>> ok, I am done ranting... > > > > -- > Ron Wheeler > President > Artifact Software Inc > email: rwhee...@artifact-software.com > skype: ronaldmwheeler > phone: 866-970-2435, ext 102 >
