cassandra-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Benedict (JIRA)" <>
Subject [jira] [Assigned] (CASSANDRA-8500) Improve cassandra-stress help pages
Date Tue, 10 Feb 2015 11:58:36 GMT


Benedict reassigned CASSANDRA-8500:

    Assignee: Benedict

> Improve cassandra-stress help pages
> -----------------------------------
>                 Key: CASSANDRA-8500
>                 URL:
>             Project: Cassandra
>          Issue Type: Improvement
>          Components: Tools
>            Reporter: Benedict
>            Assignee: Benedict
> cassandra-stress is flummoxing a lot of people. As well as rewriting its README, we should
improve the help pages so that they're more legible. 
> We should offer an "all" option that prints every sub-page, so it can be scanned like
a README (and perhaps make the basis of said file), and we should at least stop printing all
of the distribution parameter options every time they appear, as they're very common now.

> Offering some help about how to make the best out of the help might itself be a good
idea, as well as perhaps printing what all of the options within each subgroup are in the
summary page, so there is no pecking at them to be done.
> There should be a dedicated distribution help page that can explain all of the parameters
that are currently just given names we hope are sufficiently descriptive.
> Finally, we should make sure all of the descriptions of each option are clear.

This message was sent by Atlassian JIRA

View raw message