[ShahadatTest]

The API reference still describes documents and results as dictionaries, although whole-document operations now support arrays and scalar JSON values (#219). The tutorial also does not explain that replacing the root returns a new value even with in_place=True.

Document the supported value shapes, show an object-to-array root replacement, and explain why callers must use the return value. Include the distinction between the empty pointer and an empty object key, plus a null-to-boolean example. No runtime behavior changes.

Validation on Python 3.12: all 8 prompts in the new tutorial section execute successfully; source-module doctests pass; Sphinx 9.1.1 HTML builds with warnings treated as errors. git diff --check passes.

Prepared with OpenAI Codex; the examples and documentation build were run locally.

[Copilot]

🟢 Approval recommended

The documentation and examples match existing behavior, with no unresolved review findings or runtime changes.

No open issues 🎉

What changed in this PR

This documentation-only PR updates the API reference and tutorial to reflect existing support for whole-document operations on arrays and scalar JSON values. No runtime behavior changes.

Changes:

• Broaden document and result descriptions beyond dictionaries.
• Explain why callers must use the returned value after root replacement, including with in_place=True.
• Add object-to-array, empty-key, and null-to-boolean examples.

File	Description
jsonpatch.py	Update API docstrings for supported document types and root-replacement return behavior.
doc/​tutorial.rst	Explain whole-document replacement and distinguish the empty pointer from an empty object key.

_{Review effort: Balanced}

[coveralls]

coverage: 100.0%. remained the same — ShahadatTest:docs/whole-document-results into stefankoegl:master