Page MenuHomePhorge

add some information on the current release version
ClosedPublic

Authored by seigo on Apr 5 2016, 3:25 PM.
Tags
None
Referenced Files
Unknown Object (File)
Mon, Nov 25, 5:45 AM
Unknown Object (File)
Fri, Nov 22, 4:56 AM
Unknown Object (File)
Fri, Nov 22, 4:56 AM
Unknown Object (File)
Fri, Nov 22, 4:55 AM
Unknown Object (File)
Fri, Nov 22, 4:54 AM
Unknown Object (File)
Fri, Nov 22, 4:51 AM
Unknown Object (File)
Wed, Nov 13, 1:58 AM
Unknown Object (File)
Wed, Nov 6, 8:53 AM

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
Branch
master
Lint
No Lint Coverage
Unit
No Test Coverage
Build Status
Buildable 3284
Build 3259: arc lint + arc unit

Event Timeline

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

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

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

56

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?

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.

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