Docs do not describe the actual model.

Hi there, awesome project first of all!

I found that the docs do not describe the actual model for Value and Decoration.

Value

See: https://github.com/ianstormtaylor/slate/blob/master/docs/reference/slate/value.md and https://github.com/ianstormtaylor/slate/blob/master/packages/slate/src/models/value.js

The docs says the properties are:

Value({
  document: Document,
  selection: Selection,
  data: Data,
  decorations: List<Decoration>,
})

but the default properties are

const DEFAULTS = {
  annotations: undefined,
  data: undefined,
  document: undefined,
  selection: undefined,
}

Decoration

See https://github.com/ianstormtaylor/slate/blob/master/docs/reference/slate/decoration.md and https://github.com/ianstormtaylor/slate/blob/master/packages/slate/src/models/decoration.js

The docs says the properties are:

Decoration({
  anchor: Point,
  focus: Point,
  mark: Mark,
})

but the default properties are

const DEFAULTS = {
  type: undefined,
  data: undefined,
  anchor: undefined,
  focus: undefined,
}

[eselkin]

I think Decoration became Annotation and that’s why it has the data and type.

[ianstormtaylor]

I believe that this may be fixed by https://github.com/ianstormtaylor/slate/pull/3093, which has changed a lot of the logic in Slate and slate-react especially. I’m going to close this out, but as always, feel free to open a new issue if it persists for you. Thanks for understanding.