You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@accumulo.apache.org by "Christopher Tubbs (JIRA)" <ji...@apache.org> on 2016/09/29 17:06:20 UTC

[jira] [Created] (ACCUMULO-4480) User manual test results section

Christopher Tubbs created ACCUMULO-4480:
-------------------------------------------

             Summary: User manual test results section
                 Key: ACCUMULO-4480
                 URL: https://issues.apache.org/jira/browse/ACCUMULO-4480
             Project: Accumulo
          Issue Type: Task
          Components: docs
    Affects Versions: 1.8.0
            Reporter: Christopher Tubbs
             Fix For: 1.8.1, 2.0.0


I noticed today that the user manual administration chapter (administration.txt) contains information about specific older releases, which is stale.

In particular, it contains assertions about the stability of specific combinations of Accumulo, Hadoop, and ZooKeeper versions, for older Accumulo releases, based on testing. This information is not appropriate for the user manual, and would be better presented in the release notes for particular releases. The user manual should be written agnostic to the current version, whenever possible.

Additionally, the client configuration section contains information about version 1.6.0, in the present tense. Change in behavior at a version boundary should be written in such a way as to convey that a the behavior changed (past tense) across that boundary, rather than be written to correspond to the current release.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)