QUA-1690: Rename agent-q paths to agentq and Managing to How-tos

[RafaelOsiro]

Overview

Renames the agent-q/ URL paths to agentq/ and the Managing section to How-tos, completing the brand rebranding started in #1142.

Key Changes

• Folder structure: docs/agent-q/ → docs/agentq/ and docs/assets/agent-q/ → docs/assets/agentq/
• How-tos subfolder: agentq/managing/ → agentq/how-tos/ (path, nav label, and H2 in overview)
• PNG renames: standalone agent-q.png (3 locations) and step-N-agent-q-*.png (4 files) → agentq variants
• mkdocs.yml: nav paths and label updated; 21 backward-compat redirects added for old agent-q/* URLs
• overview.md grid cards: all 20 leading material icons removed (destination pages' H1s have no icon)

Pages to Test

• http://localhost:8000/agentq/overview/ — H2 reads "How-tos"; Deep Dive / How-tos / Reference cards display without leading material icons
• http://localhost:8000/agentq/api/ — page renders at new path
• http://localhost:8000/agentq/faq/ — page renders at new path
• http://localhost:8000/agentq/deep-dive/mcp/ — page renders at new path
• http://localhost:8000/agentq/how-tos/add-integration/ — page renders; step-1-agentq-icon.png, step-2-agentq-no-llm.png, step-3-agentq-configure.png load
• http://localhost:8000/agentq/how-tos/start-a-new-conversation/ — page renders; agentq-page.png screenshot loads
• http://localhost:8000/agentq/how-tos/connecting-external-ai-clients/ — page renders; numbered step screenshots load
• http://localhost:8000/using-the-platform/web-app/app-navigation/#agentq-ai-assistant — agentq.png loads
• http://localhost:8000/agent-q/overview/ — should redirect to /agentq/overview/
• http://localhost:8000/agent-q/managing/add-integration/ — should redirect to /agentq/how-tos/add-integration/
• http://localhost:8000/agent-q/deep-dive/mcp/ — should redirect to /agentq/deep-dive/mcp/

[greptile-apps]

Greptile Summary

This PR completes the AgentQ brand rebranding by renaming docs/agent-q/ → docs/agentq/ and the Managing subsection → How-tos, and updates all internal links, asset paths, and nav entries accordingly.

• Folder and asset rename: All 90 files across docs/agentq/, docs/assets/agentq/, and three standalone PNG files are moved from their agent-q/managing paths to the new agentq/how-tos equivalents.
• Backward-compat redirects: 21 new redirects from agent-q/* → agentq/* are added in mkdocs.yml, and previously-existing redirects pointing at the old agent-q/managing/* destinations have been updated to point directly to agentq/how-tos/*.
• Cross-file link hygiene: docs/glossary.md, docs/cli/examples/connect-mcp-clients.md, and docs/using-the-platform/web-app/app-navigation.md all have their agent-q/ references updated to agentq/.

Confidence Score: 5/5

Safe to merge — this is a pure documentation rename with no logic changes; all internal links, asset references, and backward-compat redirects are accounted for.

Every changed file is documentation-only. All 21 old agent-q/* URL paths have matching redirects to the new agentq/* destinations. Internal cross-doc links in glossary.md, connect-mcp-clients.md, and app-navigation.md have been updated. Asset filenames and their in-page references are consistent. No broken links or missing redirects were found.

No files require special attention. The rename is complete and internally consistent across all 90 changed files.

Important Files Changed

Filename	Overview
mkdocs.yml	Nav paths updated from agent-q/* to agentq/, Managing → How-tos label renamed, and 21 new backward-compat redirects added; pre-existing redirects for settings/integrations/ai-and-agents/ updated to point directly to agentq/how-tos/*.
docs/agentq/overview.md	New file at renamed path; H2 correctly reads "How-tos"; grid cards updated to remove leading material icons; all internal links use relative agentq/ paths.
docs/glossary.md	AgentQ, MCP, and Agentic API glossary entries updated to link to agentq/ paths; HTML anchor name="agent-q" preserved (no external links depend on it).
docs/cli/examples/connect-mcp-clients.md	Two relative links updated from agent-q/deep-dive/mcp and agent-q/managing/connecting-external-ai-clients to their agentq/how-tos equivalents.
docs/using-the-platform/web-app/app-navigation.md	Image reference updated from assets/web-app/app-navigation/agent-q.png to agentq.png; corresponding asset renamed in the same PR.
docs/agentq/how-tos/add-integration.md	New path; all step image references correctly use assets/agentq/how-tos/add-integration/ with agentq-renamed PNG files.
docs/agentq/how-tos/connecting-external-ai-clients.md	New path; all 7 step image references updated to assets/agentq/how-tos/connecting-external-ai-clients/; corresponding PNGs present in PR.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["Old URL: /agent-q/*"] -->|"redirect (mkdocs.yml)"| B["New URL: /agentq/*"]
    C["Old URL: /agent-q/managing/*"] -->|"redirect (mkdocs.yml)"| D["New URL: /agentq/how-tos/*"]
    E["Old settings/integrations/ai-and-agents/managing/*"] -->|"pre-existing redirect updated"| D
    F["Old settings/integrations/ai/*"] -->|"pre-existing redirect updated"| B
    subgraph New structure
        B --> B1["agentq/overview.md"]
        B --> B2["agentq/deep-dive/* (6 pages)"]
        B --> B3["agentq/api.md"]
        B --> B4["agentq/faq.md"]
        D --> D1["how-tos/* (12 pages)"]
    end
    subgraph Cross-file link updates
        G["docs/glossary.md"] -->|"links updated"| B1
        H["docs/cli/examples/connect-mcp-clients.md"] -->|"links updated"| B2
        I["docs/using-the-platform/web-app/app-navigation.md"] -->|"image renamed"| J["assets/web-app/app-navigation/agentq.png"]
    end

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A["Old URL: /agent-q/*"] -->|"redirect (mkdocs.yml)"| B["New URL: /agentq/*"]
    C["Old URL: /agent-q/managing/*"] -->|"redirect (mkdocs.yml)"| D["New URL: /agentq/how-tos/*"]
    E["Old settings/integrations/ai-and-agents/managing/*"] -->|"pre-existing redirect updated"| D
    F["Old settings/integrations/ai/*"] -->|"pre-existing redirect updated"| B
    subgraph New structure
        B --> B1["agentq/overview.md"]
        B --> B2["agentq/deep-dive/* (6 pages)"]
        B --> B3["agentq/api.md"]
        B --> B4["agentq/faq.md"]
        D --> D1["how-tos/* (12 pages)"]
    end
    subgraph Cross-file link updates
        G["docs/glossary.md"] -->|"links updated"| B1
        H["docs/cli/examples/connect-mcp-clients.md"] -->|"links updated"| B2
        I["docs/using-the-platform/web-app/app-navigation.md"] -->|"image renamed"| J["assets/web-app/app-navigation/agentq.png"]
    end

Loading

_{Reviews (1): Last reviewed commit: "docs(agentq): rename agent-q/ to agentq/..." | Re-trigger Greptile}