Identify where most issues are raised in the ML and fix the docs to
reduce the confusion.
I suspect that Networking is the source of most problems but perhaps
other have a better sense of this.
Ron
On 19/05/2016 8:29 AM, Ron Wheeler wrote:
Removal of duplicate information as part of item 2 . Item 5 has this
implicitly.
Item 3 +1
"Marketing" information targeted at SMB market.
Ron
On 19/05/2016 6:54 AM, Dag Sonstebo wrote:
All,
since we've added CloudStack documentation to the discussion topics
for the Montreal meetup I wanted to gauge peoples opinion on areas of
improvement.
Personally I would like to see the following:
1. Overall documentation navigation needs to be improved.
2. Ideally all documentation should be under a single
documentation tree with a single table of contents. All content
should be searchable without having to visit each of the current
documentation roots separately (Getting Started / Installation Guide
/ Admin Guide / Release Notes).
3. Advanced topics should be moved away from the "Getting Started
Docs". The people reading the getting started / concepts sections are
typically new CloudStack users who will easily be put off by
immediately being presented with advanced topics.
4. API documentation to be a chapter of the Developers guide.
5. Upgrade instructions to be moved from the release notes to the
installation guide.
6. Compatibility matrix in single location only – i.e. not in
both the release notes and installation guide as this has caused
discrepancies in the past.
I appreciate we are also working against multiple Github repositories
which complicates things slightly, but if we can overall improve the
end user experience this is worth the effort.
Thoughts?
Regards,
dag.sonst...@shapeblue.com
www.shapeblue.com
53 Chandos Place, Covent Garden, London WC2N 4HSUK
@shapeblue
--
Ron Wheeler
President
Artifact Software Inc
email: rwhee...@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
