message: Name reference improvements
diff: @@ -7,21 +7,12 @@ keywords:
  - pikelet
  ---
  -### Keywords
  -
  -The following keywords are reserved by Pikelet:
  -
  -- `Record`
  -- `record`
  -
  -:::note
  -See [Surface language - Lexical syntax - Keywords and identifiers](../specification/surface/lexical-structure#keywords-and-identifiers): <a href="../specification/surface/lexical-structure#var:keyword"><var>keyword</var></a>
  -:::
  -
  ### Identifiers
  Names refer to declarations that are currently in scope.
  +These could either be _global_, or _local_.
  +
  ```pikelet
  make-string
  Foo-23
  @@ -32,6 +23,22 @@ Unicode-String
  See [Surface language - Lexical syntax - Keywords and identifiers](../specification/surface/lexical-structure#keywords-and-identifiers): <a href="../specification/surface/lexical-structure#var:ident"><var>ident</var></a>
  :::
  +### Keywords
  +
  +Keywords use the same syntax as [identifiers](#identifiers), but are reserved by Pikelet.
  +
  +The following keywords are reserved by Pikelet:
  +
  +| Keyword | Purpose |
  +| ------- | ------- |
  +| `fun` | [Function construction](./functions#Construction) |
  +| `Record` | [Record formation](./records#Formation) |
  +| `record` | [Record construction](./records#Construction) |
  +
  +:::note
  +See [Surface language - Lexical syntax - Keywords and identifiers](../specification/surface/lexical-structure#keywords-and-identifiers): <a href="../specification/surface/lexical-structure#var:keyword"><var>keyword</var></a>
  +:::
  +
  ### Conventions
  #### Term names
  