Skip to content

Editorial review: Agent Console overview and setup pages#36947

Merged
estherk15 merged 5 commits into
ambertunnell/agent-console-updatefrom
esther/formatting-quickfix
May 22, 2026
Merged

Editorial review: Agent Console overview and setup pages#36947
estherk15 merged 5 commits into
ambertunnell/agent-console-updatefrom
esther/formatting-quickfix

Conversation

@estherk15
Copy link
Copy Markdown
Contributor

@estherk15 estherk15 commented May 22, 2026

What does this PR do? What is the motivation?

Editorial pass on the Agent Console overview and new setup pages from #36862.

Changes:

  • Add description frontmatter to _index.md and setup.md for AI/LLM discoverability per AI-friendly docs guidelines
  • Rename ## Analytics## Analyze agent usage for specificity (avoids a generic heading in RAG retrieval context)
  • Remove thin ## Set up pointer section; covered by further_reading links
  • Standardize heading casing to sentence case throughout
  • Replace "is hitting" → "is encountering", "Click" → "Select"
  • Remove redundant "their user spend" → "their spend"
  • Add Set Up Agent Console link to further_reading in _index.md

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

Depends on / intended to accompany #36862.

…le docs

- Add description frontmatter to _index.md and setup.md for AI/LLM discoverability
- Rename "## Analytics" to "## Analyze agent usage" for specificity
- Remove "## Set up" pointer section (covered by further_reading)
- Standardize heading casing (sentence case for Coding agents, Bits AI agents, User analytics)
- Replace "is hitting" with "is encountering", "Click" with "Select"
- Remove redundant "their user spend" → "their spend"
- Add Set Up Agent Console to further_reading links in _index.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR labels May 22, 2026
@estherk15 estherk15 changed the base branch from master to ambertunnell/agent-console-update May 22, 2026 14:36
@estherk15 estherk15 requested a review from ambertunnell May 22, 2026 14:37
@estherk15 estherk15 added the WORK IN PROGRESS No review needed, it's a wip ;) label May 22, 2026
@estherk15 estherk15 marked this pull request as ready for review May 22, 2026 14:37
@estherk15 estherk15 requested a review from a team as a code owner May 22, 2026 14:37
@github-actions github-actions Bot removed Architecture Everything related to the Doc backend Images Images are added/removed with this PR labels May 22, 2026
@github-actions
Copy link
Copy Markdown
Contributor

Comment thread content/en/ai_agents_console/_index.md Outdated
Comment thread content/en/ai_agents_console/_index.md
Added setup instructions for Agent Console.
@estherk15 estherk15 merged commit 8a04704 into ambertunnell/agent-console-update May 22, 2026
10 of 11 checks passed
@estherk15 estherk15 deleted the esther/formatting-quickfix branch May 22, 2026 15:45
estherk15 added a commit that referenced this pull request May 22, 2026
* [agent-console-update] Document new Agent Console features

Add sections for Agent Findings, Impact Metrics, Detected Problems,
Coding Agents dashboards, User Analytics, and Bits AI Agents tab.
Include screenshots for each surface.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Incorporate ambertunnell's feedback

- Rename Overview section to Coding Agents and the per-agent dashboards to Individual agent dashboards
- Correct Lines Generated vs Spend axis options
- Remove repo-filter sentence in Detected problems
- Swap three screenshots that were assigned to the wrong sections
- Move integration setup to a Setup sub-page and update side nav

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Update _index.md

* Add Team comparison and Top users subsections under Analytics

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Restructure Analytics tab: Team comparison first, then User Analytics group

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Editorial review: Agent Console overview and setup pages (#36947)

* Add description frontmatter and editorial improvements to Agent Console docs

- Add description frontmatter to _index.md and setup.md for AI/LLM discoverability
- Rename "## Analytics" to "## Analyze agent usage" for specificity
- Remove "## Set up" pointer section (covered by further_reading)
- Standardize heading casing (sentence case for Coding agents, Bits AI agents, User analytics)
- Replace "is hitting" with "is encountering", "Click" with "Select"
- Remove redundant "their user spend" → "their spend"
- Add Set Up Agent Console to further_reading links in _index.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Revert 'stacks up against' to 'compares your team to' for global English

* Rephrase Team comparison intro to avoid repeating 'compares/Comparison'

* Fix typo in GitHub reference in user detail view

* Include setup section for Agent Console

Added setup instructions for Agent Console.

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

* Apply suggestions from code review

Co-authored-by: Esther Kim <esther.kim@datadoghq.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Esther Kim <esther.kim@datadoghq.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

WORK IN PROGRESS No review needed, it's a wip ;)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants