Skip to content

docs: fix factual and consistency issues#48

Merged
henryiii merged 2 commits into
mainfrom
fix/factual-consistency
Jul 13, 2026
Merged

docs: fix factual and consistency issues#48
henryiii merged 2 commits into
mainfrom
fix/factual-consistency

Conversation

@henryiii

Copy link
Copy Markdown
Contributor

🤖 AI text below 🤖

Corrections surfaced by a multi-agent review of the book and slides.

  • pybind11: describe the example as C++17 (it sets CMAKE_CXX_STANDARD 17), switch deprecated PYBIND11_OVERLOAD_* macros to PYBIND11_OVERRIDE_* (chapter, slide, and the literalincluded example), bump the FetchContent GIT_TAG to v3.0.4, and note nanobind is not header-only.
  • scikit-build-core overrides: implementation-version maps to sys.implementation.version, and platform-machine/platform-node come from platform.machine()/platform.node().
  • Stable ABI: the standard-wheel example now uses the normal cp314-cp314 tag instead of the free-threaded cp314-cp314t.
  • uv: uvx environments are content-addressed and cached/reused (not recreated weekly); updated the guidance to uvx pkg@latest / --refresh. Fixed VIRTUAL_ENV variable name.
  • Rust: synced the pixi.toml snippet platforms with the example file.
  • Lazy imports: Python 3.15 is in beta; clarified that PEP 810 forbids lazy import inside try blocks and that the error-moves-to-first-use trap only arises once the guard is removed.
  • Build/rendering: renamed the duplicate pkg-build MyST label (removing a build warning), fixed two mislabeled code-block languages, converted a literal option fence to a {code} directive, re-indented a fragmented list, and pointed #1317 at the issue rather than a pull request.

Verified prek -a clean and bun run build passing with the duplicate-identifier warning gone.

Corrections surfaced by a multi-agent review:

- pybind11: C++17 (not C++11), modern PYBIND11_OVERRIDE_* macros, bump
  FetchContent GIT_TAG to v3.0.4, and note nanobind is not header-only.
- scikit-build-core overrides: fix implementation-version and
  platform-machine/platform-node source descriptions.
- Stable ABI: use the normal cp314-cp314 tag for the standard-wheel example.
- uv: uvx environments are cached and reused (not recreated weekly); use
  @latest or --refresh to update. Fix VIRTUAL_ENV variable name.
- Sync rust pixi.toml snippet platforms with the example file.
- Lazy imports: Python 3.15 is in beta; clarify lazy is forbidden in try
  blocks (PEP 810).
- Rename duplicate MyST label pkg-build to compiled-pkg-build.
- Fix code-block languages, a literal directive fence, list indentation,
  and an issue vs pull link.

Assisted-by: ClaudeCode:claude-opus-4-8
Comment thread content/compiled/02_binding.md Outdated
@henryiii henryiii merged commit 7dcf275 into main Jul 13, 2026
3 checks passed
@henryiii henryiii deleted the fix/factual-consistency branch July 13, 2026 05:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant