Priority Review Document

The Priority Review Document is a powerful feature designed to solve the "information overflow" problem inherent to Incremental Reading. It allows you to generate a custom, disposable review queue containing your highest-priority material — both Flashcards and Incremental Rems — sorted exactly how you want them.

The Problem: Why do I need this?

In the standard RemNote queue, plugins like Incremental Everything can control when Incremental Rems (articles, videos, notes) appear. However, plugins cannot control the order of standard Flashcards. RemNote's native scheduler decides which flashcard comes next, regardless of the priority you set in this plugin.

This creates a problem when you are overwhelmed. If you have 1000 due flashcards, but only time to review 50, you want to ensure those 50 are your most important ones. In the standard queue, you might spend your time reviewing low-priority trivia while critical exams or project knowledge remains unseen.

The Solution

The Priority Review Document bypasses this limitation by creating a temporary document filled with Rem References (Portals) to your most important due items.

When you practice this specific document, you are guaranteed to see:

1. High-Priority Flashcards first.
2. High-Priority Incremental Rems interleaved according to your ratio settings.
3. A manageable workload (e.g., exactly 50 items) instead of an endless queue.

How to Create a Priority Review Document

You can create a review document from anywhere in RemNote:

1. Access the Creator

• Command Palette: Type /Create Priority Review Document and press Enter.

• Document Menu: Click the 3-dots menu (...) at the top right of any document → "Create Priority Review Document".

• Queue Menu: Inside the queue, click the plugin menu icon (puzzle piece or 3-dots) → "Create Priority Review Document".

• Keyboard Shortcut: Press Opt+Shift+R (Mac) or Alt+Shift+R (Windows).

2. Configure Your Session

A popup will appear allowing you to tailor the session:

• (1) Scope:
  • Current Document: Selects high-priority items only from the document you were just viewing (and its descendants/references).
  • Full Knowledge Base: Scans your entire database to find the absolute highest priority items due today.
• (2) Number of Items: Set a hard limit (e.g., 50, 100, or 200). This helps prevent burnout by giving you a finish line.
  • Note: Due to RemNote queue gathering rules and its recursive nature, the size of the queue when you click "Practice" and enter the queue will probably be larger, as RemNote will gather e.g. rems that are referenced within the selected items.
• (3) Content Mix: Displays the current ratio of Flashcards to Incremental Rems (e.g., "6 flashcards for every incremental rem").
  • Note: This ratio is pulled from your "Sorting Criteria" settings. If the ratio is not the desired or if you can check the randomness, press the button (4) Change Sorting Criteria Settings.

3. Review

Click (5) "Create Review Document". The plugin will generate a new document tagged #Priority Review Queue and automatically open it.

1. Click the Practice button (Flashcards) on this new document.
2. Review your items as normal.
3. When finished, you can safely delete the Priority Review Document. The actual items (your cards and notes) are just references; deleting the review document does not delete your actual data.

---

How Items Are Selected

The plugin uses a sophisticated selection process to ensure you see the right material:

1. Filtering: It gathers all items (Flashcards and Incremental Rems) that are Due (scheduled for today or in the past).
2. Scoping: It filters these items based on your selected scope (Specific Document or Full KB).
3. Sorting: It ranks them by Priority (0 is highest, 100 is lowest).
4. Randomness: It applies your Sorting Criteria randomness settings.
   • Low randomness = Strict adherence to priority (0, 1, 2...).
   • High randomness = Introduces serendipity, allowing lower priority items to surface occasionally.
5. Mixing: It interleaves the lists based on your Flashcard Ratio.
   • Example: If your ratio is "6 cards per rem", the document will contain roughly 6 flashcard references followed by 1 incremental rem reference, repeating until the item limit is reached.

Priority Review Document Graph View

To help users visualize how the items are selected, a Priority Distribution Graph is automatically generated at the top of the Priority Review Document (in a rem with the Priority Review Graph powerup).

This visualization helps you verify:

• The effect of Randomness: See how "shuffled" your review session is compared to a strict priority order.
• Priority Shield Logic: Confirm that the system is correctly prioritizing your high-value items as expected.
• Scope Distribution: Visualize the balance of absolute priorities and relative percentiles within your included Incremental Rems and Flashcards.

Smart Scope & Priority Shield Integration

Even though you are reviewing a generated list, the plugin is smart enough to know where the items came from.

• Original Scope Awareness: While reviewing a Priority Review Document, the plugin "pretends" you are reviewing the original source.
• Priority Shield: The Priority Shield (the stats below the answer buttons) will calculate your protection based on the Original Scope.
  • Example: If you generate a review doc for "Biology 101", the shield will show you how well you are protecting priorities within the "Biology 101" folder, not just the temporary review document.
• Stats Tracking: The history graph will record your progress against the original document or Full KB, keeping your long-term stats accurate.

Best Practices

• The "Overwhelmed" Workflow: If you wake up to 1000+ due cards, don't panic. Create a Priority Review Document for 100 items (Full KB). Review them. If you have energy left, create another. If not, you can stop knowing you tackled the most important 100 items.
• The "Deep Dive" Workflow: If you want to focus specifically on one project, navigate to that folder, create a Priority Review Document (Current Document scope), and finish that queue completely before moving on.
• Maintain Priority Hygiene: To ensure your Priority Review Documents accurately catch your most critical content, regularly set priorities on your key documents and flashcards. Crucially, run the "Update all inherited Card Priorities" command periodically (e.g., weekly). This updates the priority inheritance across your entire knowledge base, ensuring that every single flashcard — even those you haven't manually touched — inherits the correct priority from its parent document.
• Cleanup: Get in the habit of deleting these documents after you finish the queue. They are meant to be temporary snapshots of your priorities at that specific moment. Leaving them in your collection will create unnecessary rem references to your items, cluttering the UI and making your KB heavier and slower.