title: fragment/mediawiki/state/entity/revision
description: Fields for MediaWiki revision entity.
$id: /fragment/mediawiki/state/entity/revision/1.0.0
$schema: 'https://json-schema.org/draft-07/schema#'
type: object
additionalProperties: false
properties:
  comment:
    description: The comment left by the editor when this revision was made.
    type: string
  editor:
    title: fragment/mediawiki/state/entity/user
    description: Represents the MediaWiki user that made this edit.
    $id: /fragment/mediawiki/state/entity/user/1.0.0
    $schema: 'https://json-schema.org/draft-07/schema#'
    type: object
    additionalProperties: false
    properties:
      edit_count:
        description: >
          The number of edits this user has made at the time of this event. Not
          present for anonymous users.
        type: integer
        maximum: 9007199254740991
        minimum: 0
      groups:
        description: >
          A list of the groups this user belongs to.  E.g. bot, sysop etc. Not
          present for anonymous users.
        type: array
        items:
          type: string
          minLength: 1
      is_bot:
        description: >
          True if this user is considered to be a bot at the time of this event.
          This is checked via the $user->isBot() method, which considers both
          user_groups and user permissions.
        type: boolean
      is_system:
        description: >
          True if the user is a MediaWiki 'system' user. These are users that
          cannot 'authenticate'.  These are usually listed in ReservedUsernames.
        type: boolean
      is_temp:
        description: >
          True if the user is an autocreated temporary MediaWiki user. This is
          used for IP masking.
        type: boolean
      registration_dt:
        description: >
          The datetime of the user account registration. Not present for
          anonymous users or if missing in the MW database.
        type: string
        format: date-time
        maxLength: 128
      user_id:
        description: >
          The user ID that performed this change.  This is optional, and will
          not be present for anonymous users.
        type: integer
        maximum: 9007199254740991
        minimum: 0
      user_text:
        description: >
          The user name or text representation of the user that performed this
          change.
        type: string
        minLength: 1
    examples:
      - edit_count: 1351079888211148
        groups:
          - dolor
        is_bot: false
        is_system: false
        is_temp: false
        registration_dt: '2021-01-01T00:00:00.0Z'
        user_id: 1351079888211148
        user_text: dolor
  is_comment_visible:
    description: >
      Whether the comment of the revision is visible. See
      RevisionRecord->DELETED_COMMENT.
    type: boolean
  is_content_visible:
    description: >
      Whether the revision's content body is visible. If this is false, then
      content should be redacted. See RevisionRecord->DELETED_TEXT
    type: boolean
  is_editor_visible:
    description: >
      Whether the revision's editor information is visible. Affects editor
      field. See RevisionRecord->DELETED_USER
    type: boolean
  is_minor_edit:
    description: True if the editor marked this revision as a minor edit.
    type: boolean
  rev_dt:
    description: >
      Time this revision was created. This is rev_timestamp in the MediaWiki
      database.
    type: string
    format: date-time
    maxLength: 128
  rev_id:
    description: The (database) revision ID.
    type: integer
    maximum: 9007199254740991
    minimum: 1
  rev_parent_id:
    description: This revision's parent rev_id.
    type: integer
    maximum: 9007199254740991
    minimum: 0
  rev_sha1:
    description: |
      sha1 sum considering all the content slots for this revision.
    type: string
  rev_size:
    description: >
      Byte size 'sum' of all the content slots for this revision. This 'size' is
      approximate, but may not be exact, depending on the kind of data that is
      stored in the content slots.
    type: integer
    maximum: 9007199254740991
    minimum: 0
examples:
  - comment: dolor
    editor:
      edit_count: 1351079888211148
      groups:
        - dolor
      is_bot: false
      is_system: false
      is_temp: false
      registration_dt: '2021-01-01T00:00:00.0Z'
      user_id: 1351079888211148
      user_text: dolor
    is_comment_visible: false
    is_content_visible: false
    is_editor_visible: false
    is_minor_edit: false
    rev_dt: '2021-01-01T00:00:00.0Z'
    rev_id: 1351079888211149
    rev_parent_id: 1351079888211148
    rev_sha1: dolor
    rev_size: 1351079888211148