docs: align every document with the reviewed behaviour

Assisted-by: GLM 5.3

README.md

@@ -13,16 +13,17 @@ the entire official [toml-test](https://github.com/toml-lang/toml-test) suite:
   `\xHH` escapes; integers in the four radixes with `_` separators; floats with
   exponents, `inf` and `nan`; booleans; the four date-time kinds, seconds
   optional as of 1.1; arrays and inline tables, multi-line as of 1.1.
-- **Decoding and encoding**: `Parse` for an untyped tree, `Unmarshal` and
-  `Marshal` for structs and maps, mirroring `encoding/json`.
+- **Decoding and encoding**: `Unmarshal` and `Marshal` for structs and maps,
+  mirroring `encoding/json`; `Parse` and `ParseMap` for the document with its
+  key order and the plain untyped tree.
 - **Strict decoding**: `RejectUnknownFields(true)` rejects keys that
   match no destination field, at every struct depth.
 - **Custom types**: `Marshaler` and `Unmarshaler` let a type control its own
   TOML representation in both directions, and `encoding.TextMarshaler` and
   `TextUnmarshaler` are honoured by default, so `net.IP`, `time.Duration` and
   user types with text methods need no configuration.
-- **Cancellation**: every entry point has a `*Context` sibling that honours a
-  `context.Context`.
+- **Cancellation**: the parse, decode and marshal entries have `*Context`
+  siblings that honour a `context.Context`, checked while the work runs.
 - **Ordered documents**: `Parse` gives a `*Document` that keeps the key order,
 tells an inline table from a header one, and carries the comments; `ParseMap`
 gives the plain `map[string]any` tree.
@@ -173,7 +174,8 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for the full workflow, and
 
 - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md): components and data flow
 - [docs/API.md](docs/API.md): the API reference, decoding and encoding rules
-- [docs/CLI.md](docs/CLI.md): the interpres-decode adapter and validator
+- [docs/CLI.md](docs/CLI.md): the interpres-decode adapter and validator,
+  also shipped as the manual page `man/interpres-decode.1`
 
 ## Licence