diff --git a/docs/faq.md b/docs/faq.md index c03eefe..642c62a 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -6,7 +6,7 @@ The current Fullbleed release is [MIT licensed](https://github.com/fullbleed-eng ## What do I need to install? -Python 3.10–3.14 and a Fullbleed wheel for your platform. The core has no required third-party Python runtime dependencies. See [installation](getting-started/installation.md) for the published platform list. +Standard-GIL CPython 3.10–3.15 and a Fullbleed wheel for your platform. The core has no required third-party Python runtime dependencies. See [installation](getting-started/installation.md) for the published platform list and Python 3.15 qualification. ## Can I use my existing HTML and CSS? diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index adc10a9..58786d5 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -1,10 +1,10 @@ --- title: Install Fullbleed for Python -description: Install Fullbleed on Python 3.10–3.14 for Windows, macOS, or Linux using a prebuilt wheel. +description: Install Fullbleed on Python 3.10–3.15 for Windows, macOS, or Linux using a prebuilt wheel. --- # Install Fullbleed for Python -Fullbleed supports Python 3.10–3.14. Published wheels cover Windows, macOS, and Linux, including the architectures listed below. +Current stable Fullbleed supports standard-GIL CPython 3.10–3.15. Published wheels cover Windows, macOS, and Linux, including the architectures listed below. ```bash python -m pip install fullbleed @@ -45,19 +45,27 @@ python -m pip install fullbleed The stable-ABI wheels cover supported CPython versions. For an unsupported target, a source build requires Rust; [source build instructions](https://github.com/fullbleed-engine/fullbleed-official#install) are in the engine repository. -## Python 3.15 preview + -The separate [Python Preview checks](https://github.com/fullbleed-engine/fullbleed-official/actions/runs/37720487567) -exercise CPython **3.15.0rc3**, with the standard GIL, on Windows x64 and Linux -x64. They install the same abi3 wheel tested on Python 3.10, run the installed -API and CLI checks, and compare generated PDFs and previews byte for byte. -The [coverage note](https://github.com/fullbleed-engine/fullbleed-official/blob/master/docs/python-compatibility.md) -explains the retained evidence and the explicit skip for an unavailable legacy -subinterpreter API. +## Python 3.15 final -Python 3.10–3.14 remains the supported stable range. These preview checks do not -establish compatibility with Python 3.15 final, free-threaded builds, or macOS -on this preview. +The public stable **Fullbleed 2.5.34** wheel is checked on **CPython 3.15.0 final** +on Windows x64, Linux x64, and Intel and Apple-silicon Macs. Use the ordinary +installation command above. + +Each platform's job verifies the PyPI wheel and matching release source, runs +the complete Python suite and isolated API/CLI checks, and compares generated +PDFs and previews byte for byte with the same wheel on Python 3.10. The Linux +job also checks installation in the official `python:3.15-slim` container with +networking disabled. + +The [coverage note and retained evidence](https://github.com/fullbleed-engine/fullbleed-official/blob/master/docs/python-compatibility.md) +describe the exact checks and the explicit skip for an unavailable legacy +subinterpreter API. This qualification covers standard-GIL builds; free-threaded +builds and subinterpreters remain outside its scope. + +The [earlier rc3 checks](https://github.com/fullbleed-engine/fullbleed-official/actions/runs/37720487567) +remain available as historical evidence. ## Run in Docker diff --git a/docs/index.md b/docs/index.md index f111152..8741eff 100644 --- a/docs/index.md +++ b/docs/index.md @@ -127,7 +127,7 @@ Pick your application stack. Generate a PDF locally or download one from the bro === "Python" - Use Python 3.10–3.14. The wheel includes the engine, CLI, and fonts. + Use standard-GIL CPython 3.10–3.15. The wheel includes the engine, CLI, and fonts. ```bash python -m pip install fullbleed