Skip to main content
Schoolyi

Academics

What an IT lead should document about exams, gradebooks, and report cards

A practical guide to what an IT lead should document about school exam and gradebook software, with clear owners, evidence, exceptions, and review points.

By Schoolyi Editorial Team5 min read

Document the operating model

An IT lead should document the systems, environments, owners, integrations, identities, roles, assessment definitions, grading scales, calculations, calendars, reports, backups, support routes, and change history that the school relies on.

For each process, identify source, destination, trigger, frequency, fields, identifier, transformation, validation, error route, retry, audit event, retention, and exit requirement. A system diagram is incomplete if nobody owns the handoff.

Record security and access

Maintain an access matrix for teacher, department, administrator, registrar, leader, learner, family, IT, support, supplier, and external roles. Note whether access is limited by role, subject, cohort, campus, assessment, or temporary assignment.

Document joiner, mover, leaver, recovery, privileged access, exports, support tickets, notifications, APIs, files, backups, restoration, incidents, retention, disposal, privacy, safeguarding, accessibility, records, and security review.

Make failure recoverable

Write the response for missing submission, late work, absent learner, amended mark, moderation change, resit, withdrawal, transfer, duplicate identity, changed grading period, report correction, integration failure, and outage.

State the temporary procedure, authoritative record, permitted manual action, evidence, escalation, communication, rollback, recovery target, and post-incident review. Do not solve a failed integration by creating an ungoverned permanent spreadsheet.

Keep documentation useful

The U.S. Department of Education data-quality guidance links quality with definitions, rules, validation, infrastructure, and professional learning. Review whether documentation is current, findable, tested, and understood by people who cover one another.

At 30, 60, and 90 days, check stale owners, access exceptions, failed jobs, correction time, support demand, backup evidence, report confidence, and change records. Update the smallest document that will prevent the next repeat issue.

Make the next improvement testable

Use this guidance to improve one bounded part of what an IT lead should document about school exam and gradebook software. Name the owner, assessment or gradebook record, evidence, correction route, and review date.

Check an ordinary case and one meaningful exception. If either depends on undocumented knowledge, add the missing definition, validation rule, permission, training note, or support route.

Record what changed, what remains manual, and who reviews the result before the next marking or reporting cycle.

Keep the decision beside its evidence so the next teacher or administrator can understand the rule without relying on informal memory.

Use the review to decide whether the change should be expanded, repaired, narrowed, consolidated, or held.

Recheck the boundary when a subject, campus, grading scale, role, integration, calendar, or policy changes.

Keep reading

Related articles

Back to all articles

Students walking together across a school campus at sunset

Ready to kill the spreadsheet stack?

Book a 30 minute demo. We walk through admissions, fees, exams, transport, or full cloud SMS, scoped to your school.

Already using Schoolyi? Sign in