# com.nerdballot.suggestion

> A voter's suggestion that Nerd Ballot add a book to its catalog, with evidence. Suggestions are reviewed by hand and never become eligible automatically.

- Kind: record
- Record key: tid
- Authority: nerdballot.com
- Lexicon: 1
- Published by [nerdballot.com](https://lexicon.garden/identity/did:plc:h4wwy6staenmbvom5rnwz3no), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.suggestion)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.suggestion/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.suggestion/analytics)

## Record (`com.nerdballot.suggestion`)

Type: record · key tid

### Properties

- `authors` (array, required)
  - Constraints: minLength: 1, maxLength: 10
  - `items` (string)
    - Constraints: maxLength: 1000, maxGraphemes: 100
- `coverUrl` (string · uri): Open Library cover image for the work.
  - Constraints: maxLength: 200
- `createdAt` (string · datetime, required)
- `evidenceUrls` (array): Links showing the book exists and when it was published.
  - Constraints: maxLength: 5
  - `items` (string · uri)
    - Constraints: maxLength: 1000
- `note` (string)
  - Constraints: maxLength: 10000, maxGraphemes: 1000
- `openLibraryWork` (string): Open Library work id, e.g. OL123W, when the book was picked from an Open Library lookup.
  - Constraints: maxLength: 32
- `publicationDate` (string): YYYY, YYYY-MM or YYYY-MM-DD.
  - Constraints: maxLength: 10
- `publisher` (string)
  - Constraints: maxLength: 2000, maxGraphemes: 200
- `title` (string, required)
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `version` (integer, required)
  - Constraints: minimum: 1

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "authors": {
            "items": {
              "maxGraphemes": 100,
              "maxLength": 1000,
              "type": "string"
            },
            "maxLength": 10,
            "minLength": 1,
            "type": "array"
          },
          "coverUrl": {
            "description": "Open Library cover image for the work.",
            "format": "uri",
            "maxLength": 200,
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "evidenceUrls": {
            "description": "Links showing the book exists and when it was published.",
            "items": {
              "format": "uri",
              "maxLength": 1000,
              "type": "string"
            },
            "maxLength": 5,
            "type": "array"
          },
          "note": {
            "maxGraphemes": 1000,
            "maxLength": 10000,
            "type": "string"
          },
          "openLibraryWork": {
            "description": "Open Library work id, e.g. OL123W, when the book was picked from an Open Library lookup.",
            "maxLength": 32,
            "type": "string"
          },
          "publicationDate": {
            "description": "YYYY, YYYY-MM or YYYY-MM-DD.",
            "maxLength": 10,
            "type": "string"
          },
          "publisher": {
            "maxGraphemes": 200,
            "maxLength": 2000,
            "type": "string"
          },
          "title": {
            "maxGraphemes": 300,
            "maxLength": 3000,
            "type": "string"
          },
          "version": {
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "version",
          "title",
          "authors",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A voter's suggestion that Nerd Ballot add a book to its catalog, with evidence. Suggestions are reviewed by hand and never become eligible automatically.",
  "id": "com.nerdballot.suggestion",
  "lexicon": 1
}
```