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...

Reply via email to