accumulo-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Christopher Tubbs (JIRA)" <j...@apache.org>
Subject [jira] [Created] (ACCUMULO-4480) User manual test results section
Date Thu, 29 Sep 2016 17:06:20 GMT
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)

Mime
View raw message