doc: update visibility
closes
@@ -765,7 +765,7 @@ description= who is allowed to edit this configuration setting?
[visibility]
-status= idea
+status= implemented
usedby/tool = web
type= enum
critical
@@ -773,20 +773,18 @@ type= enum
user
advanced
developer
- debug
- disabled
+ internal
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
+ - critical: setting must be changed, otherwise the system/application will fail. (e.g. boot device, hostname)
+ - important: setting has no reasonable default and most likely will fail, should be set so that application is (more) useful. (e.g. website URL to serve, relay host for mail relay)
- 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
+ - advanced: settings most users do not want to see (e.g. related to resource usage) or to enable experimental features or where defaults usually work
- 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
+ - internal: settings which should not be seen by anyone. (e.g. intermediate steps for calculations)
