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,
[email protected]
www.shapeblue.com
53 Chandos Place, Covent Garden, London WC2N 4HSUK
@shapeblue
--
Ron Wheeler
President
Artifact Software Inc
email: [email protected]
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
