Draft Restructuring #238

dirkbrnd · 2025-11-05T00:05:18Z

Restructure of the docs

## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable)

## Description Update custom logging documentation ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [x] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [x] Content is accurate and up-to-date - [x] All links tested and working - [x] Code examples verified (if applicable) - [x] Spelling and grammar checked - [ ] Screenshots updated (if applicable)

## Description - categorized knowledge section for managing knowledge and filtering knowledge in the AgentOS documentation. - Updated links . - minor tweaks . ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Willem Carel de Jongh <[email protected]>

## Description Updated and cleaned up the Dependency Injection documentation under Context Engineering. This PR improves clarity, removes repetitive content, fixes broken links, and ensures consistency across all dependency-related documentation. ## Changes Made ### File Naming - Renamed all dependency example files from underscores to hyphens for URL consistency: - Agent examples: `add_dependencies_run.mdx` → `add-dependencies-run.mdx`, etc. - Team examples: `add_dependencies_run.mdx` → `add-dependencies-run.mdx`, etc. - Reference: `run_context.mdx` → `run-context.mdx` - Updated `docs.json` with new hyphenated file names ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [x] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [x] Content is accurate and up-to-date - [x] All links tested and working - [x] Code examples verified (if applicable) - [x] Spelling and grammar checked - [ ] Screenshots updated (if applicable)

## Description Add AgentUI demo video and images, fix YFinanceTools usage, improve documentation ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [x] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [x] Content is accurate and up-to-date - [x] All links tested and working - [x] Code examples verified (if applicable) - [x] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Willem Carel de Jongh <[email protected]>

…268) ## Description Restructured the Learn section examples to improve learning progression and developer experience by reordering examples from beginner to advanced complexity, and reorganizing "More Examples" categories with clearer internal progression. ## Type of Change - [x] Content improvement - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Other: ____ ## Related Issues/PRs (if applicable)  - Closes #____ - Related SDK PR: agno-agi/agno#____ ## Checklist - [x] Content is accurate and up-to-date - [x] All links tested and working - [x] Code examples verified (if applicable) - [x] Spelling and grammar checked - [ ] Screenshots updated (if applicable) ## Files Changed - `docs.json` - Updated Learn tab navigation with nested collapsible groups ## Before/After Structure **Before:** ``` Agent Examples (27 flat list) Team Examples (8 flat list) Workflow Examples (6 flat list) ``` **After:** ``` Agent Examples ├── 5 featured examples └── More Agent Examples (accordion) ├── Content & Media (5) ├── Research & Knowledge (3) ├── Business & Analysis (4) ├── Personal Assistants (5) ├── MCP Integration (1) └── Tools & Utilities (2) Team Examples ├── 5 featured examples └── More Team Examples (accordion) └── 3 additional teams Workflow Examples (all 6 visible) ```

## Description minor tweaks. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable)

## Description - updated storage/database overview page with minor tweaks - updated links and files to use `-` instead of `_` ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Willem Carel de Jongh <[email protected]>

## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]>

Co-authored-by: Dirk Brand <[email protected]>

## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]>

## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable)

## Description [Update / Cleanup] AgentOS > Bring Your Own FastAPI App **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]>

## Description [Update / Cleanup] AgentOS > Middleware ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]>

… team, and workflow ## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Willem Carel de Jongh <[email protected]>

## Description Update AgentOS config docs ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]>

## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [x] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]> Co-authored-by: Dirk Brand <[email protected]>

## Description added: `sidebarTitle`, `keywords`, `description`, `mode: wide`, removed cookbooks reference Restructured examples to follow this pattern: 1. Create Python file first 2. Add code to file (integrated into steps, not separate section) 3. Setup virtual environment 4. Install dependencies 5. Export API key 6. Run agent 7. Link to cookbooks ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [x] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Dirk Brand <[email protected]>

## Description ### Overview Page (`concepts/guardrails/overview.mdx`) - Fixed syntax error - Added `mode: wide` to frontmatter for better code readability - Added "Learn More" ### Examples - Restructured all examples to follow the same pattern: 1. Create Python file first 2. Add code to file (integrated into steps, not separate section) 3. Setup virtual environment 4. Install dependencies 5. Export API key 6. Run Agent/Team 7. Link to cookbooks ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [x] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable) --------- Co-authored-by: Ruan Smit <[email protected]> Co-authored-by: Dirk Brand <[email protected]>

- Revisit the `AgentOS > MCP server` page and add a reference to all MCP tools available when exposing the OS as an MCP server - Minor update for the `AgentOS > MCP tools` page

Revisit the `AgentOS > Lifespan` page

…gno-docs into prototype-restructure

## Description Describe key changes, mention related issues or motivation for the changes. **Note:** Your PR title must follow conventional commit format (e.g., `docs: add auth guide`, `fix: correct broken links`, `style: update formatting`). See [CONTRIBUTING.md](../CONTRIBUTING.md) for details. ## Type of Change - [ ] Bug fix (errors, broken links, outdated info) - [ ] New content - [ ] Content improvement - [ ] Other: \_\_\_\_ ## Related Issues/PRs (if applicable)  - Closes #\_\_\_\_ - Related SDK PR: agno-agi/agno#\_\_\_\_ ## Checklist - [ ] Content is accurate and up-to-date - [ ] All links tested and working - [ ] Code examples verified (if applicable) - [ ] Spelling and grammar checked - [ ] Screenshots updated (if applicable)

dirkbrnd and others added 30 commits November 4, 2025 07:34

First draft of restructure

5c6c49b

Update

33d6bd3

Update

9765e94

update

169a8ab

Update up to dependencies

1c368f8

Merge

91d49dd

Update structure after Ashpreet

31387d2

Update

3e5afe1

Update

25f8bb0

Update

736fd41

Merge

251e4e9

Minor refactor of tools

a839953

Merge

7ab880e

Improve tool docs

4b38f69

Move all example docs

97b2813

Merge

27f33f0

Update

ca2e939

Update

c6c9729

Update

b0055bb

Update

c82cf51

updates

3f9a6fe

Update

3dd3684

Update

a34a19f

updates

23f751e

Ayush0054 and others added 30 commits November 17, 2025 09:31

Add broken links check in pipeline

6ae5578

Add broken links check in pipeline

72a4b49

updates

c4b73c9

[Update / Cleanup] AgentOS > Overview (#281)

b3f8e88

Update

d07f103

Add home page (#276)

7b404e6

[Update / Cleanup] Basics > Models (#282)

3dcd30a

Co-authored-by: Dirk Brand <[email protected]>

updates

d9bbc25

updates

a3c4b0b

updates

a36bf21

Update

67aa1b4

Update

335669d

feat: AgentOS MCP pages (#258)

d42b078

- Revisit the `AgentOS > MCP server` page and add a reference to all MCP tools available when exposing the OS as an MCP server - Minor update for the `AgentOS > MCP tools` page

feat: AgentOS custom lifespan (#259)

6de741e

Revisit the `AgentOS > Lifespan` page

Update

f52a199

Merge branch 'prototype-restructure' of https://github.com/agno-agi/a…

2061468

…gno-docs into prototype-restructure

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Draft Restructuring #238

Draft Restructuring #238

Uh oh!

dirkbrnd commented Nov 5, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

14 participants

Draft Restructuring #238

Are you sure you want to change the base?

Draft Restructuring #238

Uh oh!

Conversation

dirkbrnd commented Nov 5, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

14 participants