Revision Coverage
{{ plannedHoursLabel }}

{{ summaryLine }}

Subjects {{ validSubjects.length }} {{ coverageGapLabel }} Busiest {{ busiestDayLabel }} Next {{ nextSubjectLabel }} Blocks {{ scheduleRows.length }}
Use YYYY-MM-DD; pick the first day you can actually revise.
Subjects and exams:
Add one row per exam; use date, 1-5 scores, and 0-200 target hours.
Subject Exam date Priority Difficulty Target Actions
h
Enter 20-180 minutes; 45 or 60 keeps most revision blocks readable.
min
Enter 0-12 hours per day; use 0 for weekdays that should never receive sessions.
Balanced mixes coverage and urgency; Front-load favors closest exams; Weak-subject favors difficulty.
Choose 0-4 days; 1-2 days gives spacing without starving urgent subjects.
Choose mixed, past-paper, or recall wording for the timetable focus column.
Enter 0-7 days; 1 keeps the day before an exam free for light review.
days
Enter 1-12 hours; keep this below your real focused-study limit.
h/day
Use HH:MM, for example 16:00; later blocks include the break length.
Enter 0-45 minutes; breaks appear in times but not planned-hour totals.
min
Use YYYY-MM-DD, one per line or comma separated, e.g. 2026-05-12.
Date Time Subject Minutes Focus Exam Copy
{{ row.date_label }} {{ row.time_label }} {{ row.subject }} {{ row.minutes }} {{ row.focus }} {{ row.exam_label }}
No blocks fit before the listed exam dates.
Subject Exam Target Planned Gap Status Copy
{{ subject.name }} {{ subject.exam_label }} {{ subject.target_label }} {{ subject.planned_label }} {{ subject.gap_label }} {{ subject.status }}
No planned study blocks are available to chart for the current inputs.
Warning Detail Copy
{{ warning.title }} {{ warning.detail }}
No active warnings The current inputs fit the available study time with no overload warnings. 
{{ jsonOutput }}
Tags: Education, Productivity
Export to PDF Fullscreen
:

A revision schedule turns exam dates, subject workload, and real study capacity into a calendar that can be followed day by day. The useful version is not just a countdown. It shows when each subject will be revisited, how much time is still uncovered, and whether the planned workload is realistic before the first exam arrives.

Good revision planning gives earlier exams enough attention without letting one urgent subject crowd out everything else. It also leaves room for weaker topics, practice papers, recovery time, and ordinary school or work commitments. A plan that looks perfect on paper but assumes six high-quality hours every night is usually less useful than a smaller plan that can survive a normal week.

Revision schedule planning path A diagram showing subjects and exam dates flowing into weekly capacity, spaced study blocks, and a coverage check. Subjects exam dates targets Capacity weekday hours rest days Spacing repeat gaps exam buffer Coverage planned short or covered a useful plan balances urgency, workload, and available energy

Spacing matters because revisiting material over time supports longer-term retention better than compressing everything into one late session. Retrieval practice matters too: practice questions, blank-page recall, topic summaries from memory, and past-paper work reveal gaps that rereading can hide.

A schedule is still a planning aid, not proof of readiness. It cannot know how well a learner understands a topic, how difficult a specific paper will be, or whether an unexpected commitment will remove a study day. The safest use is to treat the timetable as a draft that should be checked against real progress.

Technical Details:

Revision scheduling is a deadline-constrained allocation problem. Each subject has a target amount of work, an exam date, and a priority signal. Each calendar day has limited capacity, and some days should be unavailable because they are rest days, blocked dates, or too close to the exam for normal revision blocks.

The planning process first removes unusable time, then divides usable capacity into fixed study blocks. A subject can receive a block only while it still has remaining target time and the date falls before its exam buffer. When more than one subject is eligible, a scoring rule ranks candidates by remaining work, urgency, priority, difficulty, and recent repetition.

Study quality is not the same thing as scheduled minutes. A two-hour evening can be valuable when it contains recall and exam-style practice, but weak if it is only passive rereading. That is why a timetable should be read together with a coverage ledger and warning list, not as a guarantee that learning has happened.

Formula Core

The subject-selection score combines workload pressure with deadline pressure. The exact weights change with the selected spacing preference, but the same inputs are always involved.

score = RwR + PwP + DwD + UwU - S - G

In this formula, R is the remaining target ratio, P is priority from 1 to 5, D is difficulty from 1 to 5, and U is urgency, calculated as 1 / (days until exam + 1). S is the same-day penalty, and G is the recent-repeat penalty when the subject has appeared inside the repeat gap.

Spacing preference Remaining work Priority Difficulty Urgency Practical effect
Balanced spacing 4.0 0.8 0.6 18 Mixes deadline pressure with remaining hours and subject importance.
Front-load earlier exams 3.0 0.7 0.4 30 Gives more pull to subjects with the closest exam dates.
Weak-subject priority 3.5 0.6 1.45 14 Moves more blocks toward subjects marked as harder.

Scheduling Boundaries

Several bounds keep the timetable from accepting impossible or extreme inputs. These limits also explain why changing one setting can make a visible difference to the result.

Boundary Accepted range or rule Effect on the timetable
Revision block length 20 to 180 minutes Sets the session size used when filling each available day.
Weekday availability 0 to 12 hours per weekday Days with 0 hours receive no blocks.
Daily load cap 1 to 12 hours per day High availability is capped, and a warning records the cap.
Exam buffer 0 to 7 days Normal blocks stop this many days before the exam date.
Repeat gap 0 to 4 days Recent subjects receive a penalty so the schedule can spread practice.
Target hours 0 to 200 hours per subject Defines how much planned time counts as coverage for that subject.
Rest or blocked dates YYYY-MM-DD dates Matching dates are skipped entirely.

Coverage Status Rules

Status Rule How to read it
Covered Planned time reaches the target, with no surplus above 30 minutes. The timetable has enough blocks for the stated target.
Near target Planned time is short, but reaches at least 80% of target. The subject is close, but still needs a deliberate adjustment.
Short Planned time is below 80% of target. The subject is under-covered under the current capacity and date rules.
Over target Planned time exceeds the target by more than 30 minutes. Review whether the extra blocks are useful or whether time should move elsewhere.

Everyday Use & Decision Guide:

Start with the first realistic study day, not the day the plan is being made. Add one row per exam subject with the exam date, priority, difficulty, and target hours. Target hours are the main workload signal; priority and difficulty decide how the planner chooses between eligible subjects when the next block could go to more than one place.

For a first pass, a 45 to 60 minute block length, Balanced spacing, a one-day repeat gap, and a one-day exam buffer usually produce a readable timetable. Use weekday availability to reflect the week as it really works. A zero-hour Sunday, a short weekday, or a longer Saturday is better than a flat schedule that no one will follow.

  • Use Front-load earlier exams when one paper is much closer than the rest and needs the calendar to react sharply.
  • Use Weak-subject priority when harder subjects should keep receiving attention even if their exam is not first.
  • Use Rest or blocked dates for travel, family events, religious observance, school activities, or recovery days that should not receive sessions.
  • Use Daily load cap to stop a high-availability day from becoming unrealistic. The warning tells you when the entered hours were reduced.
  • Use Session focus mix to label the kind of work, such as past-paper drills or recall practice. It changes the wording of sessions, not the hour allocation.

The strongest warning is a subject that remains Short. That means the current calendar cannot fit the stated target before the exam buffer. Fix it by adding study time, shortening blocks only when shorter sessions are genuinely usable, lowering an unrealistic target, removing a blocked date, or starting earlier.

Do not treat a quiet warning list as proof of exam readiness. It only means the entered dates, hours, caps, and targets fit together. The learner still needs to complete the work, mark practice answers, and adjust the next plan when a topic takes longer than expected.

Schedule generation runs in the browser, with no dedicated server-side scheduling step in this version. If you share a restored page link or exported JSON, treat subject names, exam dates, study times, and rest dates as private planning details.

Step-by-Step Guide:

Build the timetable in the same order you would check the plan: dates, subjects, time, spacing, then coverage.

  1. Set Plan start date to the first day that can actually contain revision blocks.
  2. Enter one Subjects and exams row per subject. Use the target-hours field for workload, and use the 1 to 5 priority and difficulty values to guide block selection.
  3. Choose Revision block length. Shorter blocks spread subjects more often; longer blocks reduce switching and fit deeper work.
  4. Enter Available study time for each weekday. Put 0 on days that should never receive sessions.
  5. Open Advanced if you need a different spacing preference, repeat gap, exam buffer, daily load cap, start time, break length, or blocked-date list.
  6. Read the Revision Coverage badges. Compare total planned hours with the short or surplus badge before relying on the timetable.
  7. Review Timetable for dated sessions and Coverage Ledger for subject-level target, planned, gap, and status values.
  8. Open Load Warnings before exporting or printing. Fix date errors, capped days, unused short availability, and subject shortages first.

Interpreting Results:

The headline number is total planned revision time. It should be read with the coverage gap, because the same planned total can be healthy or insufficient depending on the combined target hours across subjects. A plan with 22 planned hours is strong for an 18-hour target and weak for a 35-hour target.

Output Meaning Check before relying on it
Revision Coverage Total planned hours, subject count, coverage gap, busiest day, next subject, and block count. Confirm the gap badge is not hiding a short subject in the ledger.
Timetable Dated study blocks with time range, subject, minutes, focus label, and exam date. Scan for overloaded days, awkward start times, or sessions too near the exam.
Coverage Ledger Target, planned time, gap, and status for each subject. Treat Short as the clearest signal that the plan needs adjustment.
Study Mix Chart Planned-hour share by subject for subjects that received at least one block. Use it to spot imbalance, then verify the exact hours in the ledger.
Load Warnings Capacity caps, too-short availability, invalid rest dates, and subject shortages. Clear important warnings before sharing the plan with a student, parent, tutor, or teacher.
JSON Machine-readable inputs, summary, timetable, ledger, and warnings. Review private details before storing or sending it elsewhere.

A Near target subject is not automatically safe. Missing two hours may be acceptable for a familiar topic and risky for a weak subject with a hard paper. Use the status label as a triage cue, then decide whether the gap is acceptable for that subject.

The busiest-day badge is a stress check. If it points to a day that already has classes, travel, or another exam task, lower that day's available hours or add a blocked date and regenerate the plan.

Worked Examples:

Earlier exam needs more pull

Suppose Mathematics is in 10 days with a 12-hour target, Biology is in 18 days with a 10-hour target, and History is in 24 days with an 8-hour target. If Mathematics keeps appearing as short, switch from Balanced spacing to Front-load earlier exams and check whether the first week now carries more Mathematics blocks. If the subject is still short, the issue is capacity, not preference.

Weak subject should not disappear

A learner may have Chemistry in 20 days and Literature in 12 days, but Chemistry might be the weaker subject. Marking Chemistry with a higher difficulty score and using Weak-subject priority makes the scoring rule give it more weight. The exam date still matters, but difficulty can keep the harder subject in rotation instead of waiting until it becomes urgent.

A blocked weekend changes coverage

If Saturday usually has three available study hours but a family event blocks that date, adding it under Rest or blocked dates removes those blocks from the calendar. The coverage ledger may then move a subject from Covered to Near target or Short. That is a useful result because it shows the cost of the blocked day before the week begins.

Long blocks can hide unusable time

A weekday with 45 minutes available cannot receive a 60-minute block. If the plan warns that the day has unused availability, either reduce the block length to fit a real short session or leave the time unused and avoid pretending it will become focused revision.

Responsible Use Note:

Use the schedule as a planning worksheet, not as academic advice, school policy, or a promise of exam performance. Check syllabus requirements, teacher guidance, accommodations, wellbeing needs, and real progress before making high-stakes study decisions.

FAQ:

Does priority add more hours to a subject?

No. Target hours define the amount of coverage requested. Priority helps decide which eligible subject receives the next block when several subjects still need time.

Why did a day with available time receive no study block?

The day may be set to 0 hours, listed as a rest date, capped below the selected block length, or too close to the relevant exam because of the exam buffer.

Should the exam buffer be set to 0?

Use 0 only when normal scheduled revision should continue right up to the exam. A one-day buffer is better when the final day should be kept for light review, packing materials, sleep, or travel.

What should I do with a Short status?

Treat it as a capacity problem. Add realistic study hours, start earlier, reduce the target only if it was inflated, shorten blocks if shorter sessions are usable, or remove blocked dates that are no longer needed.

Are the subject details sent to a scheduling server?

No dedicated server-side scheduling step is used in this version. Calculations run in the browser. Shared links and exported files can still reveal the entered subject names, exam dates, and study availability.

Glossary:

Target hours
The planned amount of revision time requested for one subject.
Priority
A 1 to 5 importance score used when ranking eligible subjects for the next block.
Difficulty
A 1 to 5 weakness or challenge score that can move harder subjects higher in the schedule.
Repeat gap
The number of calendar days used to discourage repeating the same subject too soon.
Exam buffer
The number of days before an exam that are kept out of normal block scheduling.
Coverage gap
The difference between planned hours and target hours. A negative gap means the plan is short.

References: