When Should the `.documentId` Parameter be Added to the Desk Structure Schema?

 import S from '@sanity/desk-tool/structure-builder'

// Icons
import {
  House,
} from 'phosphor-react'

export const home = S.listItem()
  .title('Home')
  .icon(House)
  .child(
    S.document()
    .title('Home Page')
    .schemaType('landingPage')
  )

import S from '@sanity/desk-tool/structure-builder'

import { home } from './desk/home'
import { pages } from './desk/pages'
import { articles } from './desk/articles'
import { authors } from './desk/authors'
import { settings } from './desk/settings'

// Doc types
const hiddenDocTypes = (listItem) =>
  ![
    'landingPage',
    'page',
    'article',
    'author',
    'headerSettings',
    'footerSettings',
    'seoSettings',
    'promoSettings',
    'cookieSettings'
  ].includes(listItem.getId())

export default () =>
  S.list()
    .title('Content')
    .items([
      home,
      pages,
      articles,
      S.divider(),
      authors,
      S.divider(),
      settings,

      // Filter out docs already defined above
      ...S.documentTypeListItems().filter(hiddenDocTypes)
    ])

import S from '@sanity/desk-tool/structure-builder'

// Icons
import {
  Sliders,
  NavigationArrow,
  List,
  Globe,
  FlagBanner,
  Cookie
} from 'phosphor-react'

export const settings = S.listItem()
  .title('Settings')
  .icon(Sliders)
  .child(
    S.list()
      .title('Settings')
      .items([
        S.listItem()
          .title('Header')
          .icon(NavigationArrow)
          .child(
            S.editor()
              .schemaType('headerSettings')
              .documentId('headerSettings')
          ),
...etc.

import S from '@sanity/desk-tool/structure-builder'

// Icons
import {
  House,
} from 'phosphor-react'

export const home = S.listItem()
  .title('Home')
  .icon(House)
  .child(
    S.document()
    .title('Home Page')
    .schemaType('landingPage')
    .documentId('landingPage')
  )