When checking into doc for max_mutation_size_in_kb I noticed that there are
more Config properties that are neither in the yaml nor the DataStax doc -
or the old (outdated) Config wiki. For example, the first is
permissions_cache_max_entries.

Before suggesting/requesting that the DataStax doc guys add all the missing
properties, are there any properties in Config.java that should not be
documented or disclosed to users?

A separate question is whether "doc" for all Config properties should be
added to the yaml file, even if the actual properties are commented out.

If the answer is that not all of the properties should be documented, there
should be an annotation convention for those that should be hidden.

See:
https://github.com/apache/cassandra/blob/trunk/src/java/org/apache/cassandra/config/Config.java
https://github.com/apache/cassandra/blob/trunk/conf/cassandra.yaml

For (outdated) reference:
http://wiki.apache.org/cassandra/StorageConfiguration

-- Jack Krupansky

Reply via email to