# Search existing documentation
grep -r "featureName" Documentation/help/ --include="*.mdx"

# Check if topic is covered in related docs
grep -r "topicKeyword" Documentation/help/[section]/ --include="*.mdx"

# Look for index pages that might cover it
cat Documentation/help/[section]/index.mdx | grep -i "topic"

# UI components
grep -r "FeatureName" resources/client/ --include="*.tsx"

# Backend logic
grep -r "FeatureName" app/ --include="*.php"

# Routes
grep -r "feature-route" routes/ --include="*.php"

# Database
grep -r "feature_table" database/migrations/ --include="*.php"

# Check menu items
php artisan tinker --execute="$menus = json_decode(\DB::table('settings')->where('name', 'menus')->first()->value, true); foreach($menus as $menu) { if (in_array('auth-dropdown', $menu['positions'] ?? [])) { foreach($menu['items'] as $item) { echo $item['label'] . ' → ' . $item['action'] . PHP_EOL; } } }"

# Check specific UI components
cat resources/client/web-player/[feature]/[component].tsx | grep -E "(button|label|title)"

# What docs might link to this?
grep -r "relatedTopic" Documentation/help/ --include="*.mdx" -l

# What will this doc link to?
grep -r "prerequisiteFeature" Documentation/help/ --include="*.mdx" -l

Documentation/help/
├── [section]/                    # e.g., billing, account-settings
│   ├── index.mdx                # Section overview
│   └── [specific-topic].mdx     # Individual pages

---
audience: help
title: "Descriptive Page Title"
sidebarTitle: "Short Title"          # If different from title
description: "One-line summary for SEO and previews."
---

# List all available snippets
ls Documentation/snippets/callouts/ Documentation/snippets/warnings/ Documentation/snippets/sections/

---
audience: help
title: "Page Title"
description: "Brief description for SEO."
---

import NeedHelp from "/snippets/sections/need-help.mdx";
import PlatformFee from "/snippets/callouts/platform-fee.mdx";

# Page Title

Brief introduction (1-2 sentences explaining what this covers).

## Prerequisites (if any)

- Required plan/permission
- Previous setup needed
- Knowledge requirements

## Main Content Sections

### Section 1: Getting There

Navigation instructions with exact UI labels.

### Section 2: Using the Feature

Step-by-step instructions.

<PlatformFee />   {/* Use snippets for common callouts */}

### Section 3: Understanding Results

What to expect, how to verify success.

## Common Issues (optional)

<AccordionGroup>
  <Accordion title="Issue 1">
    Solution...
  </Accordion>
</AccordionGroup>

<NeedHelp />   {/* Use snippet for standardized support footer */}

## Related

- [Related topic](/help/path)
- [Next step](/help/path)

To manage your subscription, click your **profile avatar** in the top navigation bar, then select **Billing**. 

The **Current plan** section shows your active subscription. Click **Change plan** to switch plans.

Go to Settings → Subscription to manage your plan.
Click the Change Plan button.

Before continuing, ensure you've [set up your producer profile](/help/producer-program/after-approval).

See also: [Managing your tracks](/help/producer-dashboard/tracks)

<CardGroup cols={2}>
  <Card title="Setting Up" icon="gear" href="/help/producer-program/after-approval">
    Complete your producer profile setup
  </Card>
  <Card title="Uploading Tracks" icon="cloud-arrow-up" href="/help/producer-dashboard/tracks">
    Learn the track upload process
  </Card>
</CardGroup>

<Steps>
  <Step title="Navigate to Billing">
    Click your **profile avatar**, then select **Billing**.
  </Step>
  <Step title="Select New Plan">
    Click **Change plan**, then choose your new plan.
  </Step>
</Steps>

<Warning>
  Cancelling your plan will remove access to premium features at the end of your billing period.
</Warning>

<Tooltip tip="Credits that control how many beat requests you can create each month. Your plan determines your allowance." cta="Learn more" href="/help/beat-requests/understanding-tokens">Tokens</Tooltip> are used to create requests.

✅ Correct:
## Instant Playlist Collaboration

You can now invite other producers to collaborate on your playlists 
in real-time. Perfect for joint projects, compilations, or curated 
collections.

**What's New:**
- **Invite collaborators** — Add producers to your playlists
- **Real-time sync** — Changes appear instantly for all collaborators  
- **Permission controls** — Set who can edit or view

❌ Wrong:
## Playlist Collaboration API

We've implemented the playlist collaboration feature using WebSocket 
connections and role-based access control through the `playlist_collaborator` 
table.

**Technical Details:**
- WebSocket server handles real-time updates
- RBAC system manages permissions  
- New database schema for storing collaborators

---
audience: help
title: "How to [Do Something]"
description: "Step-by-step guide to [achieve result] on BeatPass."
---

import NeedHelp from "/snippets/sections/need-help.mdx";
{/* Import other applicable snippets: PlatformFee, SubscriptionRequired, etc. */}

# How to [Do Something]

[Brief introduction: what this accomplishes and who it's for.]

## Prerequisites

- [Requirement 1]
- [Requirement 2]

## Instructions

### Step 1: [Navigate to Location]

[Exact navigation with bold UI labels]

### Step 2: [Take Action]

[What to click/do with exact labels]

### Step 3: [Verify Result]

[What success looks like]

## Troubleshooting

<AccordionGroup>
  <Accordion title="[Common Issue 1]">
    [Solution]
  </Accordion>
  <Accordion title="[Common Issue 2]">
    [Solution]
  </Accordion>
</AccordionGroup>

<NeedHelp />

## Related

- [Related topic](/help/path)
- [Next step](/help/path)

---
audience: help
title: "[Feature Area] Overview"
description: "Learn about [feature area] and how it helps you [benefit]."
---

import NeedHelp from "/snippets/sections/need-help.mdx";
{/* Import other applicable snippets based on content needs */}

# [Feature Area] Overview

[What this feature area does and why it matters.]

## What You Can Do

<CardGroup cols={2}>
  <Card title="[Action 1]" icon="[icon]" href="/help/path">
    [Brief description]
  </Card>
  <Card title="[Action 2]" icon="[icon]" href="/help/path">
    [Brief description]
  </Card>
</CardGroup>

## Key Concepts

- **[Concept 1]**: [Explanation]
- **[Concept 2]**: [Explanation]

## Getting Started

[Link to first how-to or tutorial]

<NeedHelp />

## Learn More

- [Subtopic 1](/help/path)
- [Subtopic 2](/help/path)