doc: update visibility
proposal is in
@@ -726,9 +726,25 @@ description= who is allowed to edit this configuration setting?
[visibility]
status= idea
type= enum
+ critical
+ important
user
+ advanced
developer
+ debug
+ disabled
description= who should see this configuration setting?
+ This is the equivalent of priority in debconf.
+ If no visibility is given, "user" is assumed.
+
+ The meaning is:
+ - critical: setting must be changed, otherwise the system/application will fail
+ - important: setting has no reasonable default, must be set so that application can be useful
+ - user: often has reasonable default but most users would like to see it
+ - advanced: settings most users do not want to see, for example, related to resource usage or to enable experimental features
+ - developer: settings only relevant for developers of the application
+ - debug: settings for debugging an application
+ - disabled: settings which should not be seen by anyone, for example, which are always correctly derived or will be removed soon
