Repository navigation
Add connections and agent-security entries to the common.ai sidebar - #73837
Merged
Merged
Conversation
kaxil
force-pushed
the
commonai-docs-feedback
branch
from
September 28, 2026 11:45
df47ccb to
39a17f5
Compare
Reviewer feedback on the reorganized sidebar raised three gaps. The Security entry, which the provider docs template fixes to the vulnerability-reporting policy, sits prominently in Basics and reads as if it were about securing agents; the Securing agent tools page now sits directly under it, and opens by naming both sides of agent security, the tools an agent can reach and the data that flows in and out. Connections had no top-level entry after the reorg although readers go to them often; a new Connections page lists the seven connection types with what each is for and links to the reference for each. The Operators entry is now "Operators and decorators", since every decorator is an operator underneath and readers looking for @task.llm did not find it.
kaxil
force-pushed
the
commonai-docs-feedback
branch
from
September 28, 2026 11:47
39a17f5 to
7d3844a
Compare
kaxil
marked this pull request as ready for review
September 28, 2026 11:47
vatsrahul1001
approved these changes
Sep 28, 2026
eladkal
approved these changes
Sep 28, 2026
Lee-W
approved these changes
Sep 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Three sidebar changes from reviewer feedback on the reorganized
common.aidocs.Securing agent tools sits under Security. The Security entry in Basics is fixed by the provider docs template to the vulnerability-reporting policy, and its prominence makes it read as the place to learn about securing agents. That page cannot change, so the agent-security page now appears directly beneath it in the sidebar, and its opening names both sides of the problem: what the agent can reach (tools, connections, limits, which the provider controls) and what flows in and out (sensitive data in the context when a tool reaches an untrusted source, and the agent's output as untrusted input downstream, which the Dag author controls). The closing checklist gains an output-handling item and a sentence on tools that read untrusted sources. The page leaves the Reliability and operations toctree so it has one parent; the prose link there stays.
Connections is a top-level guide again. The reorg folded the seven connection pages under Models and providers, and readers who go straight to connection setup did not find them. A new
connections/index.rstlists each connection type with what it is for and links to its reference page. It links rather than nests, since the pages already belong to the providers toctree.Operators is now "Operators and decorators". Every
@task.*decorator is an operator underneath, and readers looking for the decorators did not open the operators entry. The page heading matches.No page moves, so no redirects.
{pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.