# app.placita.guide

> Published by [placita.app](https://lexicon.garden/identity/did:plc:sg5d3buklhrsufaej4n4hjzx)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:sg5d3buklhrsufaej4n4hjzx/app.placita.guide)
- [Documentation](https://lexicon.garden/lexicon/did:plc:sg5d3buklhrsufaej4n4hjzx/app.placita.guide/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:sg5d3buklhrsufaej4n4hjzx/app.placita.guide/examples)

## Definitions

### `app.placita.guide#entry`

**Type**: `object`

One section of a guide: a heading, the places it highlights and optional editorial text.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `note` | `string` | No | Editorial text for this guide section. Does not modify the referenced place records. |
| `places` | `array` | Yes | The places this section highlights, as strong references to app.placita.place records. |
| `title` | `string` | Yes | Heading of this section. |

### `app.placita.guide`

**Type**: `record`

A published city guide authored by a Placita account. It keeps place references and guide-specific editorial notes separate from each place record.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `city` | `string` | Yes | City the guide covers. |
| `countryCode` | `string` | No | Optional ISO 3166-1 alpha-2 country code. |
| `createdAt` | `string` (datetime) | Yes | When the guide was created. |
| `description` | `string` | No | Introduction to the guide. |
| `entries` | `array` | Yes | The guide's sections, in display order. |
| `title` | `string` | Yes | Title of the guide. |
| `updatedAt` | `string` (datetime) | Yes | When the guide was last changed. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "entry": {
      "description": "One section of a guide: a heading, the places it highlights and optional editorial text.",
      "properties": {
        "note": {
          "description": "Editorial text for this guide section. Does not modify the referenced place records.",
          "maxGraphemes": 3000,
          "maxLength": 18000,
          "type": "string"
        },
        "places": {
          "description": "The places this section highlights, as strong references to app.placita.place records.",
          "items": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "maxLength": 20,
          "minLength": 1,
          "type": "array"
        },
        "title": {
          "description": "Heading of this section.",
          "maxGraphemes": 100,
          "maxLength": 600,
          "type": "string"
        }
      },
      "required": [
        "title",
        "places"
      ],
      "type": "object"
    },
    "main": {
      "description": "A published city guide authored by a Placita account. It keeps place references and guide-specific editorial notes separate from each place record.",
      "key": "tid",
      "record": {
        "properties": {
          "city": {
            "description": "City the guide covers.",
            "maxGraphemes": 100,
            "maxLength": 600,
            "type": "string"
          },
          "countryCode": {
            "description": "Optional ISO 3166-1 alpha-2 country code.",
            "maxLength": 2,
            "pattern": "^[A-Z]{2}$",
            "type": "string"
          },
          "createdAt": {
            "description": "When the guide was created.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Introduction to the guide.",
            "maxGraphemes": 2000,
            "maxLength": 12000,
            "type": "string"
          },
          "entries": {
            "description": "The guide's sections, in display order.",
            "items": {
              "ref": "#entry",
              "type": "ref"
            },
            "maxLength": 80,
            "type": "array"
          },
          "title": {
            "description": "Title of the guide.",
            "maxGraphemes": 100,
            "maxLength": 600,
            "type": "string"
          },
          "updatedAt": {
            "description": "When the guide was last changed.",
            "format": "datetime",
            "type": "string"
          }
        },
        "required": [
          "title",
          "city",
          "entries",
          "createdAt",
          "updatedAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.placita.guide",
  "lexicon": 1
}
```