Page MenuHomekolab.org

add some information on the current release version
ClosedPublic

Authored by seigo on Apr 5 2016, 3:25 PM.

Details

Summary

some releases are previews, some are for production use .. we need
to be more explicit here. also add some info about KS AG

advantages of subscriptions

Diff Detail

Repository
rD docs
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

seigo updated this revision to Diff 255.Apr 5 2016, 3:25 PM
seigo retitled this revision from to add some information on the current release version.
seigo updated this object.
seigo edited the test plan for this revision. (Show Details)
seigo added a reviewer: Documentation Authors.
NOTE: There is no ticket associated with this differential, so all deliberations are contained within this differential. For that sake alone, the audience may need to be widened.
source/installation-guide/advantages_of_subscription.rst
1 ↗(On Diff #255)

Would this subject be better suitable for inclusion in the installation guide, or be a front-page "About" or "Introduction" type of section article?

I would like to point you to https://docs.kolab.org/introduction/index.html#introduction as linked from the front page, and suggest we consider making the title stronger, and the (set of) article(s) stronger with the content proposed in this differential.

7 ↗(On Diff #255)

This can be made <backtick>Kolab Systems AG<backtick>_

56 ↗(On Diff #255)

These numbered items can be better indented and separated line title items from explanatory text in order to both render better, as well as be more legible in their plain text versions. In and by itself very minor, might just get around to it whenever.

Other benefits of subscriptions include;

  • Inclusion of package enhancements and updates not a part of the stock distribution repositories,
  • All versions of packages released ever remain available (yum downgrade),
  • GPG signed with trusted keys on controlled infrastructure,
  • Fast-tracks available,
  • Additional H/A, L/B, config mgmt and audit infrastructure software and consultancy
source/installation-guide/index.rst
19

This will need to be templated like with the other comment I'm making later on.

24

Please use a :ref: where possible -- in this case, a ref anchor will need to be added to the actual document referred to.

27

I would propose using a |text| type templateor, such as |KE14| currently getting replaced with (badly transcripted in markup) :orange:<backtick>Kolab Enterprise 14<backtick>.

A templateor proposed could be |recommended_stable|. This would include a modification to rst_prolog in source/conf.py to include the new templateor thingy.

35

I thought the platform for this type of entitlement sales was going to be Kolab Now, correct?

seigo added inline comments.Apr 6 2016, 10:47 AM
source/installation-guide/index.rst
19

+1

27
recommended_stablemakes sense. I will implement that and update this differential.
35

It will be, but we're not there yet. When we have the ability to sell on-site licensing on kolab now, then this documentation will need updating.

seigo updated this revision to Diff 259.Apr 6 2016, 11:01 AM
  • improve wording and layout
  • name conformity, templates for release recommendations, use of ref

Typo: "become the recomended release" should be "recommended"

This revision was automatically updated to reflect the committed changes.