[IMP] Add tabs nesting check for RST

[nikibrown]

Task: https://www.odoo.com/odoo/project/3835/tasks/6083413

Issue:

Forgetting a parent .. tab:: in a group of tabs causes make fast issues

Solution:
Add checker to detect incorrect nesting in tabs

Testing:
Edit an RST file with tabs example: content/applications/marketing/events/event_reporting/attendees_report.rst and delete .. tabs:: on line 22

Run make fast and reproduce errors

Run make review on content/applications/marketing/events/event_reporting/attendees_report.rst

Expected output should be:

Enter relative content path: content/applications/marketing/events/event_reporting/attendees_report.rst 
Enter max line length (default: 100): 
content/applications/marketing/events/event_reporting/attendees_report.rst:24: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting)
content/applications/marketing/events/event_reporting/attendees_report.rst:42: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting)
content/applications/marketing/events/event_reporting/attendees_report.rst:58: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting)
content/applications/marketing/events/event_reporting/attendees_report.rst:78: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting)
content/applications/marketing/events/event_reporting/attendees_report.rst:94: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting)
make: *** [review] Error 1

Re-add parent .. tab:: and run make review. Expected output should be: No problems found.

[robodoo]

[theRealThagomizer]

Hiya, @nikibrown! I got the same failstates as yesterday with a handy error message in make review. Here's what I did.

1. Opened content/applications/sales/crm/performance/expected_revenue_report.rst and deleted .. tabs:: at line 138 (I couldn't find the file at the path you suggested so I went digging for another one with tabs in it.)
2. Ran make clean/make fast. Make fast failed. Error follows:
   `waiting for workers...

Traceback (most recent call last):
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/cmd/build.py", line 280, in build_main
app.build(args.force_all, filenames)
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/application.py", line 344, in build
self.builder.build_update()
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/builders/init.py", line 294, in build_update
self.build(to_build,
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/builders/init.py", line 308, in build
updated_docnames = set(self.read())
^^^^^^^^^^^
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/builders/init.py", line 413, in read
self._read_parallel(docnames, nproc=self.app.parallel)
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/builders/init.py", line 464, in _read_parallel
tasks.join()
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/util/parallel.py", line 108, in join
if not self._join_one():
^^^^^^^^^^^^^^^^
File "/home/odoo/github/odoo/.venv/lib/python3.12/site-packages/sphinx/util/parallel.py", line 129, in _join_one
raise SphinxParallelError(*result)
sphinx.errors.SphinxParallelError: KeyError: 'tabs_stack'

Sphinx parallel build error:
KeyError: 'tabs_stack'
make: *** [Makefile:61: html] Error 2`

3. Ran make review on same file. Errors follow:
   content/applications/sales/crm/performance/expected_revenue_report.rst:57: consider moving "Type" to line 57 (early-line-breaks) content/applications/sales/crm/performance/expected_revenue_report.rst:65: consider moving "filter." to line 65 (early-line-breaks) content/applications/sales/crm/performance/expected_revenue_report.rst:207: consider moving ":guilabel:➖" to line 207 (early-line-breaks) content/applications/sales/crm/performance/expected_revenue_report.rst:139: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting) content/applications/sales/crm/performance/expected_revenue_report.rst:163: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting) content/applications/sales/crm/performance/expected_revenue_report.rst:188: tab directive must be nested under .. tabs:: (indent it under a parent .. tabs:: block) (tabs-directive-nesting)

Seems like it's functioning as you intended? If so, you've got my approval!