Lee-W commented on code in PR #71477: URL: https://github.com/apache/airflow/pull/71477#discussion_r4045707425
########## registry/AGENTS.md: ########## @@ -462,6 +462,24 @@ They run inside Breeze where all providers are installed. `extract_metadata.py` the CI workflow can run the fast scripts (metadata, ~30s per provider) without spinning up Breeze, while parameter/connection extraction is a separate step. +### How a module gets a "Guide" link + +A module card links to the how-to guide section that documents it, alongside the +generated API reference. Nothing declares that link: `registry_tools/docs_guides.py` +reads the provider's own `docs/*.rst` and matches a class to a section when the +section's title *opens with the class name as an inline literal* — ``` ``HookToolset`` ``` +or ``` ``AgentOperator`` & ``@task.agent`` ```. The anchor is derived from the whole +title the way docutils derives its HTML id. + +That convention is what the guides already do, and it is deliberately the only Review Comment: Added a paragraph for it — growing Guide-link coverage is a matter of editing that provider's section titles, not this extractor. -- 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]
