docs: add read the docs and organize the documents

[ereali-aneo]

Motivation

The previous documentation structure was not optimized for navigation and usability. To improve clarity and ease of use, I restructured the toctree and integrated a Read the Docs interface. This will help users find information faster and better understand the documentation structure.

---

Description

• Refactored the toctree to create a more intuitive hierarchy for documentation.
• Organized Markdown (.md) files into logical sections with collapsible folders.
• Configured Read the Docs (conf.py, myst_parser, etc.) to support Markdown properly.
• Improved the sidebar navigation by grouping related topics under relevant categories.

These changes enhance the documentation experience for both new and experienced users.

---

Testing

• Built the documentation locally using Sphinx to verify that the toctree renders correctly.
• Ensured all links and cross-references function properly.
• Verified that Markdown files are correctly parsed and displayed.

---

Impact

• Documentation: The structure is now clearer, making it easier for users to navigate.
• Configuration: Added/modified conf.py settings to support Markdown (myst_parser).
• Performance: No impact on performance, as this only affects documentation.
• Dependencies: If myst-parser was not previously installed, it needs to be added (pip install myst-parser).
• Behavior: No functional changes to the codebase, only improvements in documentation accessibility.

---

Additional Information

• If necessary, update any links in the project that point to the old documentation structure.
• Ensure the Read the Docs build process is running smoothly with these changes.
• This PR does not modify any production code but significantly improves documentation usability.

Checklist

• My code adheres to the coding and style guidelines of the project.
• I have performed a self-review of my code.
• I have commented my code, particularly in hard-to-understand areas.
• I have made corresponding changes to the documentation.
• I have thoroughly tested my modifications and added tests when necessary.
• Tests pass locally and in the CI.
• I have assessed the performance impact of my modifications.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud