exclude docs from wheel; harden bundle item handling; single-source version

pyproject.toml

@@ -99,9 +99,12 @@ target = "examples"
 patterns = ["*.py", "README.md", "viz/**/*.py", "pipeline/**/*.py", "gui/**/*.py"]
 preserve_tree = true
 
-[[tool.orisys.bundle.items]]
-name = "docs"
-source = "docs"
-target = "docs"
-patterns = ["*.md", "*.pdf"]
+# NOTE: docs/ is deliberately NOT bundled into the wheel.
+# Documentation ships with the GitHub repository / PyPI project page only:
+#   - docs/publishing.md is an internal process document
+#   - docs/pypi_readme.md is read from the checkout at build time as the PyPI
+#     long description (build/wheel/package.py::PYPI_README_RELPATH), never shipped
+#   - keeping docs out means editing a doc no longer invalidates built wheels
+# Should an offline API reference be needed later, add a narrower item that ships
+# only docs/api.md.