DOCS-1789 - Consolidate Mobot monitor-creation docs, fix sidebar label - #6981
DOCS-1789 - Consolidate Mobot monitor-creation docs, fix sidebar label#6981kimsauce wants to merge 2 commits into
Conversation
create-monitor-with-mobot.md was published as a standalone page with
no cross-reference from create-monitor.md, unlike every other
alternate creation method (Terraform, dashboard/log-search entry
points), which are cross-linked rather than left to stand alone. Add
a "Using Mobot" entry mirroring the existing Terraform pattern, fix
the sidebar_label plural mismatch with its sibling doc ("Create a New
Monitor"), and trim mobot/index.md's Conversational Monitors section
down to a teaser instead of duplicating the dedicated doc's content.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
JV0812
left a comment
There was a problem hiding this comment.
Good consolidation — verified the dedicated Mobot doc already covers everything trimmed from mobot/index.md (monitor limitations, example prompts, FAQ), so no info is lost. The "Using Mobot" section mirrors the existing "Using Terraform" pattern correctly.
One thing to fix before merge: the sidebar_label rename on create-monitor-with-mobot.md isn't matched by a title update, so the sidebar nav will say "Create a Monitor with Mobot" while the page's own H1 still renders "Create Monitors with Mobot." The two new/updated links in this PR (from create-monitor.md and mobot/index.md) also use the new singular phrasing, so readers will click through to a page whose heading doesn't match what they clicked. See inline comment.
…obot.md Per JV0812's review: title was still plural while sidebar_label had been updated to singular. Drop the now-redundant sidebar_label since it matched title exactly.
JV0812
left a comment
There was a problem hiding this comment.
Title/sidebar_label mismatch resolved — title now reads "Create a Monitor with Mobot" and matches the sidebar_label used in the new cross-links. LGTM.
Purpose of this pull request
create-monitor-with-mobot.mdwas published as a standalone page with no cross-reference fromcreate-monitor.md, unlike every other alternate monitor-creation method (Terraform, dashboard/log-search entry points), which are cross-linked from the main doc rather than left to stand alone. It also has asidebar_labelplural mismatch with its sibling doc, andmobot/index.md's "Conversational Monitors" section duplicates most of its content instead of teasing it.This PR:
create-monitor.md's Other configurations, mirroring the existing "Using Terraform" pattern.create-monitor-with-mobot.md'ssidebar_labelfrom "Create Monitors with Mobot" to "Create a Monitor with Mobot", matching the singular phrasing of its sibling "Create a New Monitor."mobot/index.md's Conversational Monitors section to a short teaser, removing bullet lists (starting inputs, adjustable defaults, known limitations) that duplicated the dedicated doc — cutting the two-places-to-update problem down to one.Not touched:
create-monitor-with-mobot.md's own content, which is well-organized and just needed better cross-linking, not restructuring.Select the type of change
Ticket (if applicable)
https://sumologic.atlassian.net/browse/DOCS-1789