Skip to content

Give Pathfinder 2e an authored entrance and explicit lesson progression - #12

Merged
HarryCordewener merged 2 commits into
mainfrom
codex/pf2e-authored-learning-path
Oct 19, 2026
Merged

HarryCordewener merged 2 commits into
mainfrom
codex/pf2e-authored-learning-path

Conversation

@HarryCordewener

@HarryCordewener HarryCordewener commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

A new reader currently has to find the learning guide among reference topics. Add a pinned Start here — Learn PF2e introduction and named next-action/return blocks through the eight core lessons, retaining both Fighter and Wizard branches and the separate practice resets/day boundaries.

Bump the package and listing to 1.3.1. These are authored links and a safe generic Markdown container; the engine does not choose lesson order. Existing rules, arithmetic and source links are unchanged. Tracked by SharpMUSH/SharpMUSH#2044; broader player/architecture acceptance remains open.

Validation: the actual SharpMUSH PackageValidator passes in strict mode for all eight repository packages and index entries, including 4,725 PF2e pages. The source checker passes 22,706 links and nine journey groups and now requires the pinned entrance binding and each named progression/return link. Independent content review passed. The real installer applied the final source commit on a disposable copied world with a pre-package backup and no conflicts. Actual anonymous navigation reports eight starting-group members. The published portal completed 22 keyboard-driven lesson visits at 1440x1000/320x1000, with preserved return context and fully wrapped long related labels. Novice comprehension and full shorter-phone entry prominence remain open; SharpMUSH/SharpMUSH#2064 tracks the measured 320x800 entry gap. SharpMUSH/SharpMUSH#2065 tracks the observed large-update execution-budget warning. These are acceptance limits, not completed gates. No release tag, production package apply or deployment.

@coderabbitai

coderabbitai Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Warning

Review limit reached

  • Run on-demand review

This review includes 2 billable files and costs up to $0.50.

  • Ask an admin to make reviews automatic

Open in CodeRabbit

Reviews can continue after your included limit without a manual trigger. An admin must approve usage-based billing.

Or wait 50 minutes for your next included review.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available. Your 71 included PR review attempts over the past 7 days set your current allowance at 1 review per hour.

Learn how review limits work.

Review configuration:

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Essentials
  • Run ID: 2231276c-7212-4f95-888d-7546e56b3634
📥 Commits

Reviewing files that changed from the base of the PR and between ab497b6 and 633b144.

📒 Files selected for processing: 2
  • pf2e-remaster/package.yaml
  • tools/check-pf2e-navigation.py

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Essentials
  • Run ID: e2bc4f8e-4ff7-46f4-806a-e0888be2b7de
📥 Commits

Reviewing files that changed from the base of the PR and between 3f31586 and ab497b6.

📒 Files selected for processing: 14
  • README.md
  • index.yaml
  • pf2e-remaster/README.md
  • pf2e-remaster/package.yaml
  • pf2e-remaster/wiki/category/pf2e_start_here.md
  • pf2e-remaster/wiki/main/character_creation_guide.md
  • pf2e-remaster/wiki/main/dwarf_fighter_example.md
  • pf2e-remaster/wiki/main/dwarf_wizard_example.md
  • pf2e-remaster/wiki/main/dying_and_recovery.md
  • pf2e-remaster/wiki/main/first_encounter.md
  • pf2e-remaster/wiki/main/learn_pf2e.md
  • pf2e-remaster/wiki/main/leveling_up.md
  • pf2e-remaster/wiki/main/wizard_learning_guide.md
  • tools/check-pf2e-navigation.py

Included review availability: This review used your included allowance. 0 included reviews remain after this review. Your included PR review attempts over the past 7 days set your current allowance at 1 review per hour.

Walkthrough

The package version changes to 1.3.1. The wiki adds a pinned PF2e learning entry and navigation between instructional pages. A checker validates the entry and required next-step links.

Changes

PF2e learning path

Layer / File(s) Summary
Pinned learning entry and package release
README.md, index.yaml, pf2e-remaster/package.yaml, pf2e-remaster/README.md, pf2e-remaster/wiki/category/pf2e_start_here.md
The package version changes to 1.3.1. The wiki adds a pinned start-here category and an introductory guide with links to learning and reference pages.
Character creation and practice navigation
pf2e-remaster/wiki/main/learn_pf2e.md, pf2e-remaster/wiki/main/character_creation_guide.md, pf2e-remaster/wiki/main/dwarf_*_example.md, pf2e-remaster/wiki/main/first_encounter.md, tools/check-pf2e-navigation.py
The learning, character creation, and practice pages add next-step and return links. The checker validates the pinned entrance and required destinations in next-step blocks.
Recovery and advancement follow-up
pf2e-remaster/wiki/main/dying_and_recovery.md, pf2e-remaster/wiki/main/wizard_learning_guide.md, pf2e-remaster/wiki/main/leveling_up.md
The pages add links between recovery, advancement, rules references, and the learning path. The wizard guide notes that its level-2 example starts on a separate day.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Feature

Suggested reviewers: claude

Merge Risk: ⚪ Minimal · up to ab497

No concrete failure is identified in the authored learning links, package entry, or navigation checker. Installed-portal checks remain a follow-up before claiming the player milestone complete, not an established merge blocker.

Pre-merge checks: Passed 4 · Failed 1

Failed Failed checks: 1 warning

Check name Status Explanation Resolution
Docstring Coverage Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (13 skipped: 1… Write docstrings for the functions missing them to satisfy the coverage threshold.
Passed Passed checks: 4 passed
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly summarizes the main changes: a pinned Pathfinder 2e entrance and explicit lesson progression through the learning content.
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (13 skipped: 13 unsupported.)

Resolution

Write docstrings for the functions missing them to satisfy the coverage threshold.

✨ Finishing Touches: 💡 1
📝 Generate docstrings: 💡
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

@HarryCordewener
HarryCordewener merged commit bf43268 into main Oct 19, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant