I was reading documentation about notification email, and I thought that our docs could be improved adding a link to all the email settings. So I created a merge request: [image] check-dist (#2366873) · Jobs · Tryton / Tryton · GitLab Business Software Modularity, scalability & securit…

Rest directives can not be used in the long_description of the package (which is the index.rst).

Got it @ced . It is not big deal, but How do you feel about adding a link of the email settings on index.rst?

I would prefer to have a full upgrade of the documentation to Tryton - Documentation Guidelines which may include reference to the email configuration.

I am trying to reference to the email configuracion, but the closer I had get is: - See also :doc:`Email settings <trytond:topics/configuration>`. But my idea is to refer to /latest/server/topics/configuration.html#email

There is this comment to add anchor on configuration.

ok. I am happy to create the anchors for each section on the configuracion. Is this list correct for you? configuration-web configuration-database configuration-request configuration-cache configuration-queue configuration-error configuration-table configuration-ssl configuration-email configurati…

I think we should have the same format as in modules so it would be: config-<section>.<name>. Eg: .. _config-web: .. _config-web.listen: .. _config-web.hostname:

Reading documentation, looks like you need add the label description when adding a label without section Cross-references — Sphinx documentation :ref:`config-web` :ref:`Configuration web listen <config-web.listen>` so to move forward… maybe just create the anc…

ok. My misinterpretation about subsections. Test it and it works. I review my MergeRequest and the first commit disappear… I will try to create a new one…Thanks for your patience.

Unknown directive type "seealso"

Support Developer

Topic		Replies	Views
Links in the Documentation between modules Ideas documentation	5	581	November 4, 2020
Building doc yield warnings Developer	4	317	April 1, 2022
Remove WARNING from building jobs on documentation Developer documentation	3	152	May 8, 2024
Require documentation update for any new feature Organisation	3	608	January 2, 2024
Organize documentation's documentation Organisation documentation	9	1538	May 29, 2020

Unknown directive type "seealso"

Related topics