Fix warnings when building the readthedocs documentation

When using sphinx to build the documentation in the readthedocs repository there are a lot of warnings.

These are caused because:

• Not all the files are included in a toctree
• The glossary directive has been used to list the modules, and there are multiple definitions for some of the terms. For example Account is defined as "Fundamentals for most accounting needs." and also "Fundamentals for analytic."

assigned to @dave

added 1 deleted label and removed 1 deleted label

New review300801002 at https://codereview.tryton.org/300801002/#ps294911002

New review298981004 at https://codereview.tryton.org/298981004/#ps302451004

But using glossary seems to be a good semantic as the sentence following each link is a description. I think it will be bad to loose that for a raw listing.

I don't think the list of modules is a glossary. A glossary is a specific section where a (normally alphabetical) list of terms appear along with their definitions. These terms are then referenced from other parts of a document.

The way the module list is structured into different sections in different files, and with multiple terms (such as Account) with different definitions, suggests that it is not a glossary.

I think the definition list https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#definition-lists is structurally a better fit for the module list. It ends up being very similar to the glossary, by allowing each module to have a definition, but without requiring unique terms. It also ends up being rendered to HTML in a similar way to the current module list - https://tryton-gsod.readthedocs.io/en/latest/#modules-as-definition-list

OK so the proposed structure is actually a definition lists.

Yes, that's right. I think I should probably have used a better commit message to make that clearer.

New changeset e6901146a010 by David Harper in branch 'default':
Mark as orphans any files not in a toctree
https://hg.tryton.org/readthedocs/rev/e6901146a010

added 1 deleted label and removed 1 deleted label

closed

New changeset 2d37f58b88cc by David Harper in branch 'default':
Mark as orphans any files not in a toctree
https://hg.tryton.org/tryton-env/rev/2d37f58b88cc

review300801002 updated at https://codereview.tryton.org/300801002/#ps332531013

added 1 deleted label and removed 1 deleted label

reopened

New changeset 1d6dfbc57028 by David Harper in branch 'default':
Replace glossary with definition list
https://hg.tryton.org/readthedocs/rev/1d6dfbc57028

added 1 deleted label and removed 1 deleted label

closed

New changeset 8ce2dc77e3d1 by David Harper in branch 'default':
Replace glossary with definition list
https://hg.tryton.org/tryton-env/rev/8ce2dc77e3d1