organization of the documentation of customization variables

[Patrice Dumas]

Hello,

In a recent thread, on help-texinfo, Eli raised valid concerns on the
documentation of customization variables of texi2any, see for example:
https://lists.gnu.org/archive/html/help-texinfo/2024-03/msg00014.html

The current situation is that in the main Texinfo manual most of the
customization variables are simply presented in a list, like a
reference, not in a way that makes it easy to use them, as a tutorial
with logical groupings and background information.  In the texi2any_api
manual, the customization variables are presented in a more pedagogical
manner, but, for now, only for some variables, and the explanation of
the variables use appear in sections that may also cover some advanced
way of customizating texi2any HTML output that require knowledge of
Perl.

I think that we should decide on how the customization variables
documentation should be organized.  I think that we should keep some
reference lists in the main Texinfo manual.  But I also think that we
should make a choice regarding a pedagogical/tutorial-oriented
documentation of the customization variable, with two options (there may
be more, please add some if you have ideas):
1) document customization variables in the texi2any_api manual even
   though it will be mixed with more advanced customization which
   requires perl code
2) add sections presenting customization of texi2any output with
   customization variables in the main Texinfo manual presented in a
   tutorial fashion and remove the corresponding existing documentation
   from the texi2any_api manual.

What do you think?

-- 
Pat