Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion insights/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

The feedback tab displays quantitative thumbs up and thumbs down votes your docs have received and any qualitative feedback that users have provided. Use this information to gauge the quality of your docs and make improvements.

Access the feedback tab by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/insights).
Access the feedback tab by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).

## Feedback types

Expand Down Expand Up @@ -45,7 +45,7 @@
* **Thumbs rating, contextual, and code snippet feedback**: Complete feedback system with page voting, detailed comments, and code snippet feedback.

<Note>
If you disable telemetry in your `docs.json` file, feedback features will not appear on your documentation pages, even if you enable them in your dashboard.

Check warning on line 48 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L48

Use 'turn off' or 'off' instead of 'disable'.

Check warning on line 48 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L48

Use 'won't' instead of 'will not'.

Check warning on line 48 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L48

Avoid using 'will'.
</Note>

## Managing feedback
Expand All @@ -59,13 +59,13 @@
Best practices for setting feedback statuses:

* **Pending**: Feedback is awaiting review.
* **In Progress**: Feedback has been validated and is being worked on.

Check warning on line 62 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L62

In general, use active voice instead of passive voice ('been validated').

Check warning on line 62 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L62

In general, use active voice instead of passive voice ('being worked').
* **Resolved**: Feedback has been resolved.

Check warning on line 63 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L63

In general, use active voice instead of passive voice ('been resolved').
* **Dismissed**: Feedback has been dismissed as not actionable, irrelevant, or inaccurate.

Check warning on line 64 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L64

In general, use active voice instead of passive voice ('been dismissed').

### Filtering by status

Use the status filter to control which feedback is displayed. Clear a status to hide all feedback with that status. By default, all feedback is displayed.

Check warning on line 68 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L68

In general, use active voice instead of passive voice ('is displayed').

Check warning on line 68 in insights/feedback.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/feedback.mdx#L68

In general, use active voice instead of passive voice ('is displayed').

### Adding internal notes

Expand Down
2 changes: 1 addition & 1 deletion insights/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

The overview tab shows how many people have visited your docs, what pages are most popular, and where users are coming from. Use this information to identify which pages are most valuable to your users and track trends over time.

Access the overview metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/insights).
Access the overview metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).

## Metrics

Expand All @@ -14,7 +14,7 @@

- **Visitors**: Unique visitors
- **Views**: Total page views
- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks

Check warning on line 17 in insights/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/overview.mdx#L17

Spell out 'CTA', if it's unfamiliar to the audience.
- **Popular Pages**: Paths to the most-visited pages and their view counts
- **Referrers**: Top traffic sources directing users to your docs

Expand All @@ -22,5 +22,5 @@

Review your overview analytics to:

- **Identify popular pages**: Use popular pages to understand what content is most important to your users so that you can make sure it is up to date and comprehensive.

Check warning on line 25 in insights/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/overview.mdx#L25

Use 'it's' instead of 'it is'.
- **Track traffic trends**: Monitor changes in traffic to understand the impact of updates or new content.