Investigate why some files give issues during documentation generation

[FedericoCalzoni]

In the current implementation of the automatic documentation generation for python packages, docs are generated thanks to the script gen_ref_pages present in the srcipts/ folder.

However some python packages and files are being skipped. This was done since they were causing issues in the building of the documentation. Thus, some investigation is needed.

Code reference:
https://github.com/ubm-driverless/ubm-docs/blob/a773831ea79f8535e5b8668ab12a492557af6d7a/scripts/gen_ref_pages.py#L15C1-L19C5

[TorioCrema]

I tried to generate the doc on my docker container and I removed these lines from gen_ref_pages.py:

ubm-docs/scripts/gen_ref_pages.py

Lines 15 to 18 in a773831

	# Skip files containing the following kywords in their path
	if any(part in {"old_stuff", "f1tenth_stack", "provide_map_launch", "launch", "deprecated"} for part in path.parts):
	logging.info(f"Skipping: {path}")
	continue

The only error I got was:

ERROR   -  mkdocstrings: ai_controller.old_stuff.ai_controller_at_the_gym could not be found
ERROR   -  Error reading page 'PYTHON_PACKAGES/ai_controller/old_stuff/ai_controller_at_the_gym.md':
ERROR   -  Could not collect 'ai_controller.old_stuff.ai_controller_at_the_gym'

which i fixed by removing the old_stuff directory from the ai_controller package.

[Scheggetta]

@Noce99

[Noce99]

ok to remove it, if needed we have it in the repo history.