diff --git a/src/revisions/revision.dto.ts b/src/revisions/revision.dto.ts
index e40330623..1c9748eca 100644
--- a/src/revisions/revision.dto.ts
+++ b/src/revisions/revision.dto.ts
@@ -8,12 +8,30 @@ import { IsDate, IsNumber, IsString } from 'class-validator';
 import { Revision } from './revision.entity';
 
 export class RevisionDto {
+  /**
+   * ID of this revision
+   * @example 13
+   */
   @IsNumber()
   id: Revision['id'];
+
+  /**
+   * Markdown content of the revision
+   * @example "# I am a heading"
+   */
   @IsString()
   content: string;
+
+  /**
+   * Patch from the preceding revision to this one
+   */
   @IsString()
   patch: string;
+
+  /**
+   * Datestring of the time this revision was created
+   * @example "2020-12-01 12:23:34"
+   */
   @IsDate()
   createdAt: Date;
 }