[raymondyou97]

What does this PR do? What is the motivation?

Documents the limit_count and limit_period tags used to query configured requests per window. Includes an example metric query grouped by period and explains tag availability and historical-data limitations. Retains separate metric families for allowed and blocked requests and child_org_name for child-organization views, without introducing redundant tags.

No prebuilt dashboard changes are required. The example query is for customers' own metric exploration and visualizations; it does not introduce a new section in the integration dashboard.

Merge readiness

• Ready for merge
• Confirm the documented tags are available in each target site before publishing.

AI assistance

Pi assisted with the content update, source comparison, and validation.

Additional notes

• Updates the live Astro API documentation source; translated and retired Hugo copies are unchanged.
• Markdoc parsing and validation against the repository schema pass.
• Vale reports no new findings compared with the unchanged page (five existing warnings and four existing suggestions).
• Repository pre-commit checks pass.
• No production site build or publication was performed.

[github-actions]

Preview links (active after the build_preview check completes)

No changed files under hugo/content/en/, e.g. this PR only touches the Astro API docs app:

• https://docs-staging.datadoghq.com/raymond-you/ratelimit-tag-docs/api/latest/