Make docs valid according to guides 0.3.3

[greg0ire]

Cc @linawolf @jaapio

Here are the warnings that are left:

[2024-02-12T22:38:40.171860+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.178561+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.181593+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.183047+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.184515+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.187207+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.187977+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.193160+00:00] app.WARNING: No template found for rendering directive "sectionauthor". Expected template "body/directive/sectionauthor.html.twig" [] []
[2024-02-12T22:38:40.384154+00:00] app.WARNING: No template found for rendering directive "toc". Expected template "body/directive/toc.html.twig" [] []
[2024-02-12T22:38:40.384251+00:00] app.WARNING: No template found for rendering directive "tocheader". Expected template "body/directive/tocheader.html.twig" [] []
[2024-02-12T22:38:40.388428+00:00] app.WARNING: No template found for rendering directive "toc". Expected template "body/directive/toc.html.twig" [] []
[2024-02-12T22:38:40.388493+00:00] app.WARNING: No template found for rendering directive "tocheader". Expected template "body/directive/tocheader.html.twig" [] []
[2024-02-12T22:38:40.411127+00:00] app.WARNING: No template found for rendering directive "toc". Expected template "body/directive/toc.html.twig" [] []
[2024-02-12T22:38:40.411187+00:00] app.WARNING: No template found for rendering directive "tocheader". Expected template "body/directive/tocheader.html.twig" [] []

I suppose the next step could be to create some kind of doctrine extension for the guides that will contain the templates mentioned above, based on

• https://github.com/doctrine/doctrine-website/blob/master/lib/RST/Directive/SectionAuthorDirective.php
• https://github.com/doctrine/doctrine-website/blob/master/lib/RST/Directive/TocHeaderDirective.php
• https://github.com/doctrine/doctrine-website/blob/master/lib/RST/Directive/TocDirective.php

?

[jaapio]

I think you can replace the toc node with a container directive. As it is nothing more than just a wrapper?

For the others you would indeed need an extension that adds the templates and directives to your documentation builder.

If needed I can help you with that, even if it was just missing documentation on our side.

[linawolf]

@greg0ire @jaapio as the sectionauthor seems to be an official sphinx directive we could also add it directly to the guides: https://certik.github.io/sphinx/markup/desc.html

[jaapio]

Yes please 🙏