Sphinx docs integration

[trushant05]

Summary

Sphinx-based documentation generation workflow is introduced in this PR.

Contents

• aic_docs/Dockerfile : Introduced inside docker/ to provide a consistent environment for Sphinx docs generation.
• conf.py: Located inside docs/, this file handles all Sphinx-specific configurations, including Markdown parsing and theme settings.
• GitHub Action: Added .github/workflows/build_sphinx_docs.yml which triggers specifically on changes to the docs/ directory.

Preview from Github Action

1. Look at the latest run of Sphinx Docs Github Action,
2. Look at the specific Build Docs job.
3. In the Update docs artifact step you can download build artifact.
4. Extract and open index.html.

Preview and Update Locally

• Fetch image assets from media branch into aic/../:

  ./docker/aic_docs/fetch_docs_assets.sh

Note

Above script will clone aic repo media branch at the same directory level as aic.

├── aic
│   ├── docker
│   ├── docs
├── media

• Build aic_docs docker image:

  cd docker
  docker compose build docs

• Start docs compose service to serve Sphinx docs:

   docker compose up docs

Note

Documentation will be served on localhost at port 8000.