Add reviewer persona for docs

[esethna]

Adds a Cursor rule defining a mock junior system admin persona.

Used to guide documentation reviews through the lens of a less experienced Mattermost administrator.

[github-actions]

Newest code from mattermost has been published to preview environment for Git SHA e2daad2

[coderabbitai]

📝 Walkthrough

Walkthrough

A new Cursor documentation reader persona configuration file for a junior system administrator was added. The file includes metadata for applying the persona to Markdown and reStructuredText files, along with detailed guidance on evaluating documentation quality from this user's perspective.

Changes

Cohort / File(s)	Summary
Cursor Documentation Persona Configuration .cursor/rules/docs-reader-persona-junior-sysadmin.mdc	New persona configuration file defining a junior system administrator's documentation reader profile, including background context, technical skill level, documentation quality criteria, and review guidance points such as prerequisite clarity, jargon definition, troubleshooting coverage, and procedural clarity.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately and concisely summarizes the main change: adding a new reviewer persona configuration for documentation review.
Description check	✅ Passed	The description is directly related to the changeset, explaining that it adds a Cursor rule for a junior system admin persona to guide documentation reviews.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs-reviewer-persona

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

.cursor/rules/docs-reader-persona-junior-sysadmin.mdc (1)

14-16: Inconsistent punctuation in persona attributes.

Line 14 ends with a period ("small team)"), while line 16 does not ("on-the-job experience"). For consistency, either both should have trailing punctuation or neither should.

✨ Proposed fix for consistent punctuation

 **Name:** Jeff  
-**Role:** Junior IT Administrator (solo or small team)  
+**Role:** Junior IT Administrator (solo or small team)
 **Experience:** 1–2 years in IT, primarily help desk and basic network/device support  
 **Education:** No formal CS or development background; self-taught from tutorials and on-the-job experience

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In @.cursor/rules/docs-reader-persona-junior-sysadmin.mdc around lines 14 - 16,
The persona attribute lines are inconsistent: the "Role:"/line containing
"Junior IT Administrator (solo or small team)" ends with a period while the
"Education:"/line containing "No formal CS or development background;
self-taught from tutorials and on-the-job experience" does not; make them
consistent by either removing the trailing period after "small team)" or adding
a trailing period after "on-the-job experience" so both attribute lines use the
same punctuation style.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In @.cursor/rules/docs-reader-persona-junior-sysadmin.mdc:
- Around line 14-16: The persona attribute lines are inconsistent: the
"Role:"/line containing "Junior IT Administrator (solo or small team)" ends with
a period while the "Education:"/line containing "No formal CS or development
background; self-taught from tutorials and on-the-job experience" does not; make
them consistent by either removing the trailing period after "small team)" or
adding a trailing period after "on-the-job experience" so both attribute lines
use the same punctuation style.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2a6adec9-abb3-40b8-aa71-8ec05c1e9bc6

📥 Commits

Reviewing files that changed from the base of the PR and between b888ded and e2daad2.

📒 Files selected for processing (1)

• .cursor/rules/docs-reader-persona-junior-sysadmin.mdc