Files
Soumya Ranjan Mohanty da5ebb6601 Add docs for API & the agent architecture (#22)
* Add docs for API & the agent
* Add reAct arch diagram
2025-12-05 22:51:22 +05:30

130 lines
3.2 KiB
YAML

site_name: Geo Assistant
repo_name: developmentseed/geo-assistant
repo_url: https://github.com/developmentseed/geo-assistant
site_description: Geo Assistant
site_author: Development Seed
# Note: trailing slash recommended with mike:
# https://squidfunk.github.io/mkdocs-material/setup/setting-up-versioning/#publishing-a-new-version
site_url: https://developmentseed.org/geo-assistant/
docs_dir: docs
extra:
social:
- icon: "fontawesome/brands/github"
link: "https://github.com/developmentseed"
- icon: "fontawesome/brands/bluesky"
link: "https://bsky.app/profile/developmentseed.org"
- icon: "fontawesome/brands/linkedin"
link: "https://www.linkedin.com/company/development-seed"
version:
alias: true
provider: mike
nav:
- Home: index.md
- Tools: tools/index.md
- API: api/index.md
watch:
- docs
theme:
language: en
name: material
custom_dir: docs/overrides
logo: assets/logo_no_text.png
palette:
# Palette toggle for automatic mode
- media: "(prefers-color-scheme)"
toggle:
icon: material/brightness-auto
name: Switch to light mode
# Palette toggle for light mode
- media: "(prefers-color-scheme: light)"
primary: default
accent: deep orange
toggle:
icon: material/brightness-7
name: Switch to dark mode
# Palette toggle for dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: default
accent: deep orange
toggle:
icon: material/brightness-4
name: Switch to system preference
font:
text: Roboto
code: Roboto Mono
features:
- content.code.annotate
- content.code.copy
- navigation.indexes
- navigation.instant
- navigation.tracking
- search.suggest
- search.share
extra_css:
- overrides/stylesheets/extra.css
plugins:
- search
- social:
enabled: !ENV [CI, false]
- mike:
alias_type: "copy"
canonical_version: "latest"
- mkdocstrings:
enable_inventory: true
handlers:
python:
options:
docstring_section_style: list
docstring_style: google
line_length: 80
separate_signature: true
show_source: true
show_root_heading: true
show_signature_annotations: true
show_symbol_type_toc: true
signature_crossrefs: true
# extensions:
# - griffe_inherited_docstrings
# https://github.com/developmentseed/titiler/blob/50934c929cca2fa8d3c408d239015f8da429c6a8/docs/mkdocs.yml#L115-L140
markdown_extensions:
- admonition
- attr_list
- codehilite:
guess_lang: false
- def_list
- footnotes
- md_in_html
- pymdownx.arithmatex
- pymdownx.betterem
- pymdownx.caret:
insert: false
- pymdownx.details
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
- pymdownx.escapeall:
hardbreak: true
nbsp: true
- pymdownx.magiclink:
hide_protocol: true
repo_url_shortener: true
- pymdownx.smartsymbols
- pymdownx.superfences
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.tilde
- toc:
permalink: true