docs.coopcloud.tech/mkdocs.yml

---
site_author: Co-op Cloud
site_name: "Co-op Cloud: Docs"
site_url: https://docs.coopcloud.tech
use_directory_urls: true

theme:
  name: material
  features:
      navigation.instant.progress
    - content.action.edit
    - navigation.expand
    - navigation.indexes
    - navigation.instant
    - navigation.path
    - navigation.sections
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.top
    - navigation.tracking
  palette:
    primary: light pink
    accent: purple
  logo: img/favicon.ico
  favicon: img/favicon.ico
  custom_dir: custom_theme/

copyright: Copyleft 2020-2025 Co-op Cloud

markdown_extensions:
  - admonition
  - attr_list
  - codehilite:
      guess_lang: false
  - def_list
  - footnotes
  - md_in_html
  - meta
  - toc:
      permalink: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.details
  - pymdownx.emoji:
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
      emoji_index: !!python/name:material.extensions.emoji.twemoji
  - pymdownx.magiclink
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.tabbed
  - pymdownx.tilde
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format

nav:
  - "Introduction":
      - index.md
      - "Frequently Asked Questions": intro/faq.md
      - "Project Strategy": intro/strategy.md
      - "Comparisons": intro/comparisons.md
      - "Inspirations": intro/inspirations.md
      - "Project Status": intro/bikemap.md
      - "Managed Hosting": intro/managed.md
      - "Get In Touch": intro/contact.md
      - "Credits": intro/credits.md
      - intro/get-involved.md
      - intro/glossary.md
      - "Support Us": intro/support.md
  - "Maintainers":
      - maintainers/index.md
      - "How to Become a Recipe Maintainer": maintainers/maintain.md
      - "Package your First Recipe Tutorial": maintainers/tutorial.md
      - "Recipe config upgrade checklist": maintainers/upgrade.md
      - "Packaging Handbook": maintainers/handbook.md
      - maintainers/catalogue.md
  - "Operators":
      - operators/index.md
      - "New operators Tutorial": operators/tutorial.md
      - "Operators Handbook": operators/handbook.md      
  - "Federation":
      - federation/index.md
      - federation/handbook.md
      - federation/organisers.md
      - federation/kite-flying-pad-archive.md
      - "Bylaws": federation/bylaws.md
      - "Finance": federation/finance.md
      - "Membership": federation/membership.md
      - "Joining the Co-op Cloud Federation": federation/join.md
      - "Code of Co-operation": federation/code-of-coop.md
      - "Shared Infrastructure Inventory": federation/infra.md
      - "Proposals":
        - federation/proposals/index.md
        - federation/proposals/federation.md
      - "Resolutions":
          - federation/resolutions/index.md
          - "Draft":
              - federation/resolutions/index.md
          - "Passed":
              - federation/resolutions/passed/001.md
              - federation/resolutions/passed/002.md
              - federation/resolutions/passed/003.md
              - federation/resolutions/passed/004.md
              - federation/resolutions/passed/005.md
              - federation/resolutions/passed/006.md
              - federation/resolutions/passed/007.md
              - federation/resolutions/passed/008.md
              - federation/resolutions/passed/009.md
              - federation/resolutions/passed/010.md
              - federation/resolutions/passed/011.md
              - federation/resolutions/passed/012.md
              - federation/resolutions/passed/014.md
              - federation/resolutions/passed/015.md
              - federation/resolutions/passed/016.md
              - federation/resolutions/passed/017.md
              - federation/resolutions/passed/018.md
              - federation/resolutions/passed/019.md
              - federation/resolutions/passed/020.md
              - federation/resolutions/passed/021.md
              - federation/resolutions/passed/022.md
              - federation/resolutions/passed/023.md
              - federation/resolutions/passed/024.md
              - federation/resolutions/passed/025.md
              - federation/resolutions/passed/026.md
              - federation/resolutions/passed/027.md
              - federation/resolutions/passed/028.md
              - federation/resolutions/passed/029.md
              - federation/resolutions/passed/032.md
              - federation/resolutions/passed/031.md
              - federation/resolutions/passed/033.md
              - federation/resolutions/passed/034.md
              - federation/resolutions/passed/035.md
              - federation/resolutions/passed/036.md
              - federation/resolutions/passed/037.md
              - federation/resolutions/passed/038.md
              - federation/resolutions/passed/039.md
          - "Stalled":
              - federation/resolutions/stalled/013.md
              - federation/resolutions/stalled/030.md
          - "In Progress":
              - federation/resolutions/index.md
              - federation/resolutions/in-progress/040.md
      - "Minutes":
          - federation/minutes/index.md
          - "Recently":
              - federation/minutes/2025-12-28.md
          - "Archive":
              - federation/minutes/2024-08-15.md
              - federation/minutes/2024-04-17.md
              - federation/minutes/2024-03-29.md
              - federation/minutes/2024-02-01.md
              - federation/minutes/2022-03-03.md
              - federation/minutes/2023-05-03.md
      - "Digital Tools": federation/tools.md
      - "Funding applications":
          - federation/funding-applications/index.md
          - federation/funding-applications/culture-of-solidarity.md
          - federation/funding-applications/ford-foundation.md
          - federation/funding-applications/private-funder.md
          - federation/funding-applications/sovereign-tech-fund.md
          - federation/funding-applications/user-operated-internet.md
  - "Abra":
      - abra/index.md
      - "Install": abra/install.md
      - "Quick Start": abra/quickstart.md
      - "Upgrade": abra/upgrade.md
      - "Design": abra/design.md
      - "Recipes": abra/recipes.md
      - "Hack": abra/hack.md
      - "Troubleshoot": abra/trouble.md
      - "Cheat Sheet": abra/cheat-sheet.md
      - "Swarm mode almanac": abra/swarm.md
  - "Specifications":
      - specs/index.md
      - "Backups":
          - specs/backup/index.md
          - specs/backup/maintain.md
          - specs/backup/spec.md

plugins:
  - awesome-pages
  - search
  - redirects:
      redirect_maps:
        "get-involved/support/index.md": intro/support.md

repo_name: toolshed/docs.coopcloud.tech
repo_url: https://git.coopcloud.tech/toolshed/docs.coopcloud.tech/
edit_uri: _edit/main/docs/

extra_css:
  - styles/extra.css