Opportunity cards seem noisy or wrong

Overview

This guide helps when Docs opportunity cards feel noisy, irrelevant, or incorrect. You’ll learn how to mute or dismiss individual cards, adjust which detectors run per repository, and understand which cosmetic findings Moxie already filters out.

Use these steps to keep your dashboard focused on high‑value work and reduce alert fatigue for your team.

Before you start

• You have access to your Moxie Docs workspace dashboard.
• You can see the repositories connected to Moxie Docs.
• To change repository-wide detector settings, you must be a workspace admin.

A card is irrelevant or already handled

You might see a card that you’ve already fixed in a recent PR or that doesn’t apply to your project. Use the built‑in actions to clear it from view.

1. Open the Dashboard and scroll to Docs opportunities.
2. Click the card’s overflow menu (three dots •••).
   • Choose Dismiss to remove it from your view. Dismissed items won’t reappear unless the underlying content changes again.
   • Choose Mute to silence this specific item so it won’t notify you, but similar future items can still appear.
3. Confirm the action if prompted. The card disappears immediately, keeping the dashboard tidy.

Too many cards from one type of finding

If your dashboard is flooded by a certain category (for example, thin docs or convention mismatches), you can tune detectors per repository so only what you care about is shown.

1. Go to Account → Settings and open the PR automation tab.
2. Find the repository you want to adjust.
3. Toggle off detectors you don’t need for that repo:
   • thin — flags very short or low‑detail docs.
   • convention_mismatch — flags docs that don’t match your style or naming.
   • undocumented_api — flags public API areas without docs.
   • stale_content — flags likely out‑of‑date docs and adds a severity pill.
4. Save your changes. Existing rows for disabled detectors are hidden from the dashboard but their history is kept. You can re‑enable any time.

A card’s severity seems wrong

Severity applies to stale content findings. If a card looks too urgent or not urgent enough, you can tone down the noise while keeping the signal.

1. Triage the item from the Docs opportunities list.
2. Click the overflow menu (•••) on the card.
3. Choose Mute to keep the record but stop seeing alerts for this specific item, or Dismiss if you’ve addressed it.
4. If many stale items feel mis‑classified, adjust the stale_content detector for that repo under Account → Settings → PR automation by toggling it off temporarily while you catch up, then re‑enable later.

I’m seeing purely cosmetic nits

Moxie hides cosmetic findings by default so you shouldn’t see alerts about trivial changes like spacing or minor punctuation.

1. Review the card details. If it’s only cosmetic, it likely came from a broader issue (for example, a convention mismatch that affects style).
2. Dismiss the card if it doesn’t warrant action, or Mute it to prevent repeat noise from that specific item.
3. Consider turning off convention_mismatch for that repo under Account → Settings → PR automation if your team doesn’t enforce formatting conventions.

Cards don’t match what’s in my latest PRs

Sometimes the dashboard lags behind your most recent docs-only PRs or merges.

1. Refresh the Dashboard and wait a moment for opportunities to update.
2. Dismiss any cards you just addressed by using the card’s overflow menu.
3. If the pattern keeps repeating, toggle the relevant detector off and back on under Account → Settings → PR automation to reset what’s displayed for that repo.

Still need help

• Recheck that you’re editing the correct repository in Account → Settings → PR automation.
• Confirm you have admin rights if detector toggles are disabled.
• If issues persist, contact your workspace admin to review repository settings and access. They can also reach Moxie Support with details about the cards and the repository involved.