Documentation

Final Year Project Documentation Guide

Documentation is usually worth as many marks as the software, and it is the part teams consistently underestimate. Writing sixty pages in the final week produces a document that is visibly rushed, and reviewers notice missing diagrams and copy-pasted definitions immediately.

This guide covers what each document actually contains, the order to write them in, and the details that separate a report that reads as professional from one that reads as assembled overnight.

11 min read

The documents you will be asked for

DocumentPurposeWhen to write it
Synopsis / abstractOne-page summary of problem, approach and outcomeBefore development, refined at the end
SRSNumbered functional and non-functional requirementsAfter design review, before coding
Design documentArchitecture, ER diagram, UML set, screen designsAlongside implementation of each module
Test documentTest cases with expected and actual resultsAs each module is completed
Project reportThe full narrative from problem to conclusionChapter by chapter throughout
User manualHow to install and operate the systemFinal two weeks

Write in this order, not front to back

  1. Start with the implementation chapter as each module is finished — the details are fresh and it is the hardest chapter to reconstruct later.
  2. Write the design chapter next, correcting the diagrams to match what you actually built rather than what you planned.
  3. Add the testing chapter as tests are run, capturing real outputs rather than idealised ones.
  4. Write the literature survey and the existing-system study when you have time between build milestones.
  5. Write the results and conclusion once the system is complete and measured.
  6. Write the abstract last. It is a summary of what exists, and writing it first guarantees it will be wrong.

Diagrams that are actually required

  • System architecture: components and how data moves between them. Every report needs this one.
  • ER diagram: entities, attributes and relationships with cardinality marked.
  • Data flow diagram: level 0 and level 1 at minimum, for departments that require DFDs.
  • Use case diagram: actors and what each can do — the fastest way to show role separation.
  • Sequence diagram: for your two or three most important flows, such as login or booking.
  • Class diagram: for object-oriented projects, and expected in most MCA submissions.
  • Deployment diagram: where components run, particularly for cloud and IoT projects.

Screenshots that look professional

  • Crop to the relevant region. Full desktop captures with a visible taskbar look careless.
  • Use realistic seed data. Screens filled with test1, test2 and asdf undermine the whole report.
  • Number and caption every figure, and refer to each one from the body text.
  • Keep a consistent window size across captures so the report looks composed rather than collected.
  • Include error states, not only success states — showing validation working is evidence of quality.

Writing test cases panels accept

A test case table needs an identifier, the input, the expected result, the actual result and a pass or fail status. Tables where every row passes look invented; include the failures you found and fixed, with a note that they were resolved.

IDTest caseInputExpectedActualStatus
TC-01Login with valid credentialsRegistered email and passwordDashboard loadsDashboard loadsPass
TC-02Login with wrong passwordValid email, wrong passwordError message, no sessionError message shownPass
TC-03Book an already-taken slotSlot booked by another userBooking rejectedRejected with messagePass
TC-04Submit form with empty required fieldBlank name fieldValidation errorInitially accepted — fixed in v1.2Pass

Citations and academic honesty

Cite every dataset, paper, library and code source you used. A report with no references reads as though nothing was researched; a report with references you clearly did not read reads worse, because panels ask what a specific paper concluded.

Where you adapted existing code, say so and describe what you changed. This is normal engineering practice and is treated far better than an undisclosed copy discovered during the viva.

Formatting details that cost marks

  • Follow your department's template exactly — margins, font, line spacing and heading style.
  • Number every figure and table, and reference each from the text.
  • Keep a consistent tense: past tense for what you did, present tense for what the system does.
  • Do not paste generic definitions of well-known technologies; explain how you used them instead.
  • Check page numbers, the table of contents and the list of figures after the final edit — these break silently.
Talk to CodeLab69

Need help with your final year project?

Tell us your branch, your domain and your first review date. You will get a scope suggestion and an honest timeline before you commit to anything.