I have added a first prototype of a generated configuration parameter reference page for the forthcoming version 5.1 of NaviServer.
https://naviserver.sourceforge.io/5.1/manual/files/admin-config-params.html
The page is generated from a machine-readable Tcl dict that contains section names, parameter names, types, defaults, allowed values, short descriptions, and deprecation notes. The same dict is also used by the (not yet released) 'nsstats' module to provide online help via tooltips for all parameters on the page showing the current configuration settings of a running server.
The current version already covers many areas relevant for OpenACS and NaviServer installations in general: global parameters, network drivers, per-server settings, connection pools, server modules such as `nslog`, `nscgi`, `nsperm`, `revproxy`, and database configuration including `nsdb`, pools, and PostgreSQL/Oracle drivers.
The page is still a prototype, therefore feedback would be very helpful. In particular on what is missing that would make configuration work easier for OpenACS developers and site maintainers?
NaviServer 5.1 will come with many additions also concerning configuration management, including the option to use configuration directories common to many other packages
https://naviserver.sourceforge.io/5.1/manual/files/admin-config.html
All the best
-g
