Implemented the generation of API documentation from docstrings for external Brainglobe repositories using Sphinx and autodoc, starting with brainglobe-atlasapi.
fetch_external.py to automate cloning or pulling the latest changes for specified external Brainglobe repositories into an external/ directory.docs/source/conf.py to include the external/ paths in Python's sys.path for Sphinx to find modules and enabled Sphinx extensions like autodoc and autosummary.brainglobe-atlasapi, first using MDX and then refactoring to a dedicated reStructuredText (.rst) file (docs/source/api/brainglobe_atlasapi.rst).docs/source/documentation/brainglobe-atlasapi/index.md to link to the newly generated brainglobe-atlasapi API reference.fetch_external.py to automatically install the fetched external repositories using pip.fetch_external.py: New script for managing external repos.docs/source/conf.py: Core Sphinx configuration for documentation build.docs/source/api/brainglobe_atlasapi.rst: New file for brainglobe-atlasapi API reference.docs/source/api/brainglobe_atlasapi_api.md (deleted): Initial attempt at MDX-based API docs.docs/source/documentation/brainglobe-atlasapi/index.md: Entry point for brainglobe-atlasapi documentation.sphinx.ext.autodoc, sphinx.ext.autosummary, Python's subprocess module for git and pip commands.external/ directory, and their Python packages are made available to Sphinx by modifying sys.path. API documentation is generated using Sphinx's automodule directives, specifying members for inclusion.fetch_external.py script adds pip install commands for the fetched repositories to ensure they are available in the build environment.