kaxil opened a new pull request, #73837: URL: https://github.com/apache/airflow/pull/73837
Three sidebar changes from reviewer feedback on the reorganized `common.ai` docs. **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.rst` lists 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. --- * Read the **[Pull Request Guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#pull-request-guidelines)** for more information. Note: commit author/co-author name and email in commits become permanently public when merged. * For fundamental code changes, an Airflow Improvement Proposal ([AIP](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Improvement+Proposals)) is needed. * When adding dependency, check compliance with the [ASF 3rd Party License Policy](https://www.apache.org/legal/resolved.html#category-x). * For significant user-facing changes create newsfragment: `{pr_number}.significant.rst`, in [airflow-core/newsfragments](https://github.com/apache/airflow/tree/main/airflow-core/newsfragments). You can add this file in a follow-up commit after the PR is created so you know the PR number. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
