Unknown directive type "seealso"

Support Developer
1

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:

Now it is failing because it does not like the seealso directive.
But I did copy from the Party documentation, so I am not sure what I did wrong.
Can anyone tell me what is wrong with that code?

2

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

3

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

4

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

5

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

6

There is this comment to add anchor on configuration.

7

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
configuration-session
configuration-password
configuration-attachment
configuration-bus
configuration-html
configuration-wsgi_middleware
8

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:
9

2 posts were split to a new topic: Remove commit from a topic

10

Reading documentation, looks like you need add the label description when adding a label without section
https://www.sphinx-doc.org/en/master/usage/referencing.html#role-ref

:ref:`config-web`
:ref:`Configuration web listen <config-web.listen>`

so to move forward… maybe just create the anchors for each section until find another cleaner way to refer to the config.section.name?

11

They all are a title section.

12

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.

13

This is mercurial, you must amend not add commit. Adding commits make reviewing a painful task.

14

Except of course if there should be two commits because it is two different changes.