pyquantlib 0.7.0__tar.gz → 0.8.0__tar.gz

pyquantlib-0.8.0/.dockerignore

@@ -0,0 +1,24 @@
+# Local environments & build artifacts (platform-specific)
+venv/
+build/
+dist/
+wheelhouse/
+_skbuild/
+*.egg-info/
+
+# Caches and compiled files (any level)
+**/__pycache__/
+**/*.py[cod]
+**/*.so
+**/*.pyd
+**/.DS_Store
+
+# Generated docs output
+docs/_build/
+
+# Root dot-files and dot-directories 
+.*
+
+# Only README.md is needed at the root (pyproject readme); skip other top-level notes
+/*.md
+!/README.md

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/.github/scripts/build-quantlib-windows.ps1

@@ -27,7 +27,8 @@ New-Item -ItemType Directory -Path build -Force | Out-Null
 Push-Location build
 
 Write-Host "Configuring QuantLib..."
-cmake .. -G "Visual Studio 17 2022" -A x64 `
+# No -G pin: CMake picks the runner's newest VS, matching scikit-build-core.
+cmake .. -A x64 `
     -DCMAKE_BUILD_TYPE=Release `
     -DCMAKE_INSTALL_PREFIX=C:/quantlib `
     -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL `
@@ -39,9 +40,13 @@ cmake .. -G "Visual Studio 17 2022" -A x64 `
     -DQL_BUILD_BENCHMARK=OFF `
     -DBoost_INCLUDE_DIR=C:/boost/include
 
+if ($LASTEXITCODE -ne 0) { throw "QuantLib CMake configure failed" }
+
 Write-Host "Building QuantLib..."
 cmake --build . --config Release --parallel
 
+if ($LASTEXITCODE -ne 0) { throw "QuantLib build failed" }
+
 Write-Host "Installing QuantLib..."
 cmake --install . --config Release
 

pyquantlib-0.8.0/.github/workflows/docker.yml

@@ -0,0 +1,86 @@
+# PyQuantLib: Python bindings for QuantLib
+# Copyright (c) 2025 Yassine Idyiahia
+#
+# QuantLib is Copyright (c) 2000-2025 The QuantLib Authors
+# QuantLib is free software under a modified BSD license.
+# See http://quantlib.org/ for more information.
+#
+# Source: https://github.com/quantales/pyquantlib
+# Licensed under the BSD 3-Clause License. See LICENSE file for details.
+
+name: Docker image
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "Dockerfile"
+      - ".dockerignore"
+      - "src/**"
+      - "include/**"
+      - "CMakeLists.txt"
+      - "pyproject.toml"
+      - ".github/workflows/docker.yml"
+  pull_request:
+    paths:
+      - "Dockerfile"
+      - ".dockerignore"
+      - "src/**"
+      - "include/**"
+      - "CMakeLists.txt"
+      - "pyproject.toml"
+      - ".github/workflows/docker.yml"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          load: true
+          tags: pyquantlib:ci
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Smoke test
+        run: |
+          docker run --rm pyquantlib:ci python -c "
+          import pyquantlib as ql
+          print('PyQuantLib', ql.__version__)
+          # Exercises the Settings singleton: the canary for a correct static QuantLib build.
+          ql.Settings.evaluationDate = ql.Date(15, ql.January, 2025)
+          assert ql.Settings.evaluationDate == ql.Date(15, ql.January, 2025)
+          q = ql.SimpleQuote(100.0)
+          assert q.value() == 100.0
+          print('Smoke test passed')
+          "
+
+      - name: JupyterLab server test
+        run: |
+          # Launch the image with its real CMD and confirm the server serves /lab.
+          docker run -d --rm --name pql-jupyter -p 8888:8888 pyquantlib:ci
+          ready=0
+          for i in $(seq 1 30); do
+            code=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8888/lab || true)
+            if [ "$code" = "200" ]; then
+              echo "JupyterLab responded with HTTP 200 (attempt $i)"
+              ready=1
+              break
+            fi
+            echo "attempt $i: HTTP $code, waiting..."
+            sleep 2
+          done
+          if [ "$ready" -ne 1 ]; then
+            echo "JupyterLab did not become ready in time; container logs:"
+            docker logs pql-jupyter || true
+          fi
+          docker stop pql-jupyter
+          test "$ready" -eq 1

pyquantlib-0.8.0/.github/workflows/docs.yml

@@ -0,0 +1,129 @@
+# PyQuantLib: Python bindings for QuantLib
+# Copyright (c) 2025 Yassine Idyiahia
+#
+# QuantLib is Copyright (c) 2000-2025 The QuantLib Authors
+# QuantLib is free software under a modified BSD license.
+# See http://quantlib.org/ for more information.
+#
+# Source: https://github.com/quantales/pyquantlib
+# Licensed under the BSD 3-Clause License. See LICENSE file for details.
+
+name: Docs
+
+# Builds the docs against PyQuantLib compiled from this checkout, so autodoc
+# resolves bindings that are not in the published wheel yet. Read the Docs
+# builds against the PyPI wheel instead, which means types added since the last
+# release are missing from the live site until the next release ships.
+
+env:
+  QUANTLIB_VERSION: "1.42.1"
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "examples/**"
+      - "src/**"
+      - "include/**"
+      - ".readthedocs.yaml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "examples/**"
+      - "src/**"
+      - "include/**"
+      - ".readthedocs.yaml"
+      - ".github/workflows/docs.yml"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: 'pip'
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libboost-all-dev cmake ninja-build
+
+      # Same key as the Linux build job, so this is normally a cache hit.
+      - name: Cache QuantLib
+        id: cache-quantlib
+        uses: actions/cache@v4
+        with:
+          path: /home/runner/quantlib-install
+          key: quantlib-${{ env.QUANTLIB_VERSION }}-static-ubuntu-latest-v1
+          restore-keys: |
+            quantlib-${{ env.QUANTLIB_VERSION }}-static-ubuntu-latest-
+
+      - name: Build QuantLib from source
+        if: steps.cache-quantlib.outputs.cache-hit != 'true'
+        run: |
+          wget https://github.com/lballabio/QuantLib/releases/download/v${{ env.QUANTLIB_VERSION }}/QuantLib-${{ env.QUANTLIB_VERSION }}.tar.gz
+          tar xzf QuantLib-${{ env.QUANTLIB_VERSION }}.tar.gz
+          cd QuantLib-${{ env.QUANTLIB_VERSION }}
+          mkdir -p build && cd build
+          cmake .. -G Ninja             -DCMAKE_BUILD_TYPE=Release             -DCMAKE_INSTALL_PREFIX=/home/runner/quantlib-install             -DBUILD_SHARED_LIBS=OFF             -DCMAKE_POSITION_INDEPENDENT_CODE=ON             -DQL_USE_STD_SHARED_PTR=ON             -DQL_USE_STD_OPTIONAL=ON             -DQL_USE_STD_ANY=ON             -DQL_BUILD_EXAMPLES=OFF             -DQL_BUILD_TEST_SUITE=OFF             -DQL_BUILD_BENCHMARK=OFF
+          ninja
+          ninja install
+
+      - name: Install documentation dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r docs/requirements.txt
+
+      # Replaces the PyPI wheel pulled in above. conf.py keeps the source tree
+      # on sys.path once a compiled extension is present there.
+      - name: Build PyQuantLib from this checkout
+        run: |
+          pip install -e . -v
+        env:
+          QuantLib_ROOT: /home/runner/quantlib-install
+          LD_LIBRARY_PATH: /home/runner/quantlib-install/lib
+
+      - name: Build HTML with warnings as errors
+        run: |
+          python -m sphinx -b html -W --keep-going docs docs/_build/html
+        env:
+          LD_LIBRARY_PATH: /home/runner/quantlib-install/lib
+
+      - name: Upload built docs
+        uses: actions/upload-artifact@v4
+        with:
+          name: html
+          path: docs/_build/html
+          retention-days: 7
+
+  linkcheck:
+    runs-on: ubuntu-latest
+    # External links break for reasons outside this repository, so a failure
+    # here is reported but does not block the branch.
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: 'pip'
+
+      - name: Install documentation dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r docs/requirements.txt
+
+      - name: Check links
+        run: |
+          python -m sphinx -b linkcheck docs docs/_build/linkcheck

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/.github/workflows/linux.yml

@@ -29,7 +29,7 @@ on:
       - ".github/workflows/linux.yml"
 
 env:
-  QUANTLIB_VERSION: "1.41"
+  QUANTLIB_VERSION: "1.42.1"
 
 jobs:
   build:

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/.github/workflows/macos.yml

@@ -29,7 +29,7 @@ on:
       - ".github/workflows/macos.yml"
 
 env:
-  QUANTLIB_VERSION: "1.41"
+  QUANTLIB_VERSION: "1.42.1"
 
 jobs:
   build:

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/.github/workflows/wheels.yml

@@ -19,7 +19,7 @@ on:
     types: [published]
 
 env:
-  QUANTLIB_VERSION: "1.41"
+  QUANTLIB_VERSION: "1.42.1"
   BOOST_VERSION: "1.86.0"
 
 jobs:
@@ -68,6 +68,11 @@ jobs:
           CIBW_SKIP: "*-musllinux_*"
           CIBW_BUILD_VERBOSITY: 1
 
+          # manylinux2014 is past EOL and current NumPy no longer publishes
+          # wheels for it, so the in-container test step fell back to building
+          # NumPy from source against a too-old GCC. AlmaLinux 8 based image.
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+
           # macOS: ARM only (macos-14)
           CIBW_ARCHS_MACOS: "arm64"
           CIBW_ARCHS_LINUX: "x86_64"

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/.github/workflows/windows.yml

@@ -29,7 +29,7 @@ on:
       - ".github/workflows/windows.yml"
 
 env:
-  QUANTLIB_VERSION: "1.41"
+  QUANTLIB_VERSION: "1.42.1"
   BOOST_VERSION: "1.86.0"
   BOOST_VERSION_UNDERSCORE: "1_86_0"
 
@@ -89,7 +89,7 @@ jobs:
           mkdir build -Force | Out-Null
           cd build
           Write-Host "Configuring QuantLib with std:: flags..."
-          cmake .. -G "Visual Studio 17 2022" -A x64 `
+          cmake .. -A x64 `
             -DCMAKE_BUILD_TYPE=Release `
             -DCMAKE_INSTALL_PREFIX=C:/quantlib-install `
             -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL `

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/.gitignore

@@ -121,6 +121,9 @@ Desktop.ini
 # Documentation build
 /docs/_build/
 
+# Notebooks staged into the docs tree at build time (see docs/conf.py)
+/docs/examples/notebooks/
+
 # Local configuration overrides
 .env.local
 *.local.cmake

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/CONTRIBUTING.md

@@ -447,7 +447,7 @@ pybind11 enum values are singletons. Never pass by reference and modify:
 
 - Place ABCs in the `base` submodule via `manager.getSubmodule("base")`
 - Use trampolines for classes with pure virtual methods
-- Some classes require `py::classh` and `trampoline_self_life_support` -- see [Diamond Inheritance](docs/design/diamond-inheritance.md)
+- Some classes require `py::classh` and `trampoline_self_life_support` for classes that inherit from two bases sharing a common virtual ancestor
 - Export concrete implementations to the main module
 
 ---

pyquantlib-0.8.0/Dockerfile

@@ -0,0 +1,95 @@
+# syntax=docker/dockerfile:1.6
+# PyQuantLib Docker image (multi-stage)
+#
+# Stage 1 builds QuantLib (static) and compiles a self-contained PyQuantLib wheel.
+# Stage 2 is a slim runtime with only the wheel + JupyterLab; the build toolchain,
+# Boost headers, and QuantLib source never reach the final image.
+#
+# Build:   docker build -t pyquantlib:latest .
+# Run:     docker run --rm -p 8888:8888 pyquantlib:latest
+# Then open http://localhost:8888 in a browser.
+
+# ==============================================================================
+# Stage 1: builder
+# ==============================================================================
+FROM python:3.11-slim AS builder
+
+# Build-time system dependencies. QuantLib needs a C++ toolchain and Boost
+# headers; Ninja matches the CI build.
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        build-essential \
+        cmake \
+        ninja-build \
+        libboost-all-dev \
+        wget \
+        ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+# Build and install QuantLib from source (STATIC).
+# QuantLib MUST be a static library built with PIC and the std:: type flags:
+# a shared build duplicates the Settings singleton and breaks evaluationDate.
+# Mirrors .github/workflows/linux.yml.
+ARG QUANTLIB_VERSION=1.42.1
+WORKDIR /tmp
+RUN wget --quiet https://github.com/lballabio/QuantLib/releases/download/v${QUANTLIB_VERSION}/QuantLib-${QUANTLIB_VERSION}.tar.gz \
+    && tar xzf QuantLib-${QUANTLIB_VERSION}.tar.gz \
+    && cd QuantLib-${QUANTLIB_VERSION} \
+    && cmake -B build -G Ninja \
+        -DCMAKE_BUILD_TYPE=Release \
+        -DCMAKE_INSTALL_PREFIX=/usr/local \
+        -DBUILD_SHARED_LIBS=OFF \
+        -DCMAKE_POSITION_INDEPENDENT_CODE=ON \
+        -DQL_USE_STD_SHARED_PTR=ON \
+        -DQL_USE_STD_OPTIONAL=ON \
+        -DQL_USE_STD_ANY=ON \
+        -DQL_BUILD_EXAMPLES=OFF \
+        -DQL_BUILD_TEST_SUITE=OFF \
+        -DQL_BUILD_BENCHMARK=OFF \
+    && cmake --build build \
+    && cmake --install build \
+    && cd /tmp \
+    && rm -rf QuantLib-${QUANTLIB_VERSION}*
+
+# Build a self-contained PyQuantLib wheel. The static QuantLib is linked into the
+# extension and Boost is header-only, so the wheel needs no QuantLib at runtime.
+# QuantLib_ROOT lets scikit-build-core's CMake find the static install above.
+ENV QuantLib_ROOT=/usr/local
+WORKDIR /src
+COPY . /src
+RUN pip install --no-cache-dir --upgrade pip build \
+    && pip wheel . --no-deps -w /wheels
+
+# ==============================================================================
+# Stage 2: runtime
+# ==============================================================================
+FROM python:3.11-slim AS runtime
+
+# C++ runtime the compiled extension links against (matches the builder's gcc).
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        libstdc++6 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install the PyQuantLib wheel plus the JupyterLab + scientific stack.
+COPY --from=builder /wheels /wheels
+RUN pip install --no-cache-dir /wheels/*.whl \
+        jupyterlab \
+        numpy \
+        scipy \
+        matplotlib \
+        pandas \
+    && rm -rf /wheels
+
+# Example notebooks for interactive use.
+WORKDIR /app
+COPY examples/ /app/examples/
+COPY README.md /app/
+
+EXPOSE 8888
+
+CMD ["jupyter", "lab", \
+     "--ip=0.0.0.0", \
+     "--port=8888", \
+     "--no-browser", \
+     "--allow-root", \
+     "--ServerApp.token=", \
+     "--ServerApp.password="]

{pyquantlib-0.7.0 → pyquantlib-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: pyquantlib
-Version: 0.7.0
+Version: 0.8.0
 Summary: Python bindings for QuantLib
 Keywords: quantlib,quantitative-finance,derivatives,pricing,risk,fixed-income,options,finance,pybind11
 Author-Email: Yassine Idyiahia <yassine.id@gmail.com>
@@ -96,15 +96,17 @@ Description-Content-Type: text/markdown
 
 ## Overview
 
-PyQuantLib provides Python bindings for [QuantLib](https://www.quantlib.org/), the open-source library for quantitative finance. Built with [pybind11](https://github.com/pybind/pybind11), it offers a more Pythonic API than existing alternatives.
+PyQuantLib provides Python bindings for [QuantLib](https://www.quantlib.org/), the open-source library for quantitative finance. It is built on [pybind11](https://github.com/pybind/pybind11): every binding is written in standard C++, with no interface-definition language and no code-generation step between the caller and the QuantLib source.
+
+As an independent project, PyQuantLib complements the official [QuantLib-SWIG](https://github.com/lballabio/QuantLib-SWIG) bindings, which remain the established and most widely used way to run QuantLib from Python.
 
 ## Features
 
-- **Pythonic API**: Pass Python objects directly to functions (implicit conversion)
-- **Zero-copy NumPy**: Buffer protocol for efficient, bidirectional data exchange
-- **Type hints**: IDE-friendly with complete `.pyi` stub files
-- **Python subclassing**: Extend QuantLib classes without C++ recompilation
-- **Modern build**: scikit-build-core, CMake presets, cross-platform CI/CD
+- **Pythonic API**: pass quotes and term structures directly; handles are created internally. Plain Python types convert automatically, and `None` replaces `Null<Real>()`.
+- **Zero-copy NumPy**: `Array` and `Matrix` use the buffer protocol, so `np.array(arr, copy=False)` shares memory with no marshalling.
+- **Type hints**: complete `.pyi` stubs ship in the wheel for autocomplete and type-checking.
+- **Python subclassing**: override QuantLib's abstract base classes via pybind11 trampolines, without C++ recompilation.
+- **Modern build**: scikit-build-core, CMake presets, cross-platform CI.
 
 ## Installation
 
@@ -112,49 +114,17 @@ PyQuantLib provides Python bindings for [QuantLib](https://www.quantlib.org/), t
 pip install pyquantlib
 ```
 
-Pre-built wheels are available for Python 3.10--3.13 on Linux (x86_64), macOS (ARM), and Windows (x64). QuantLib is statically linked -- no separate installation required.
-
-### From Source
-
-Building from source requires QuantLib built with specific CMake flags. See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions.
-
-#### Prerequisites
+Pre-built wheels are available for Python 3.10 to 3.13 on Linux (x86_64), macOS (ARM), and Windows (x64). QuantLib is statically linked, so no separate installation is required.
 
-- Python 3.10+
-- CMake 3.18+
-- C++17 compatible compiler
-- Boost headers
-- **QuantLib 1.40+** built with `std::shared_ptr` support (see below)
+### From source
 
-#### QuantLib Build Requirement
-
-> **Important**: PyQuantLib requires QuantLib built from source with specific settings.
-
-**Required CMake flags:**
-
-```bash
-cmake -DBUILD_SHARED_LIBS=OFF \
-      -DCMAKE_POSITION_INDEPENDENT_CODE=ON \
-      -DQL_USE_STD_SHARED_PTR=ON \
-      -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL \  # Windows only
-      -DCMAKE_BUILD_TYPE=Release \
-      ...
-```
-
-| Flag | Why Required |
-|------|--------------|
-| `BUILD_SHARED_LIBS=OFF` | Static build prevents Settings singleton issues on Linux/macOS |
-| `CMAKE_POSITION_INDEPENDENT_CODE=ON` | Required for static libs in Python modules |
-| `QL_USE_STD_SHARED_PTR=ON` | pybind11 uses `std::shared_ptr` as default holder |
-| `CMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL` | **Windows only**: Python extensions require dynamic runtime (`/MD`) |
-
-**Note**: Pre-built packages (Homebrew, vcpkg, apt) use shared builds and `boost::shared_ptr` -- they are **not compatible**. You must build QuantLib from source. See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed build instructions.
+Building from source requires QuantLib 1.42+ compiled with specific CMake flags. Packages from Homebrew, vcpkg, and apt use shared builds and `boost::shared_ptr`, and are not compatible. See [CONTRIBUTING.md](CONTRIBUTING.md) for the required flags and full build instructions.
 
 ```bash
 pip install git+https://github.com/quantales/pyquantlib.git
 ```
 
-## Quick Start
+## Quick start
 
 ```python
 import pyquantlib as ql
@@ -166,42 +136,33 @@ ql.Settings.evaluationDate = today
 # Market data
 spot = ql.SimpleQuote(100.0)
 rate = ql.SimpleQuote(0.05)
-vol = ql.SimpleQuote(0.20)
+vol  = ql.SimpleQuote(0.20)
 
-# Term structures (pass quotes directly, handles created internally)
-dc = ql.Actual365Fixed()
-risk_free = ql.FlatForward(today, rate, dc)
-dividend = ql.FlatForward(today, 0.0, dc)
+# Term structures (pass quotes directly; handles created internally)
+dc         = ql.Actual365Fixed()
+risk_free  = ql.FlatForward(today, rate, dc)
+dividend   = ql.FlatForward(today, 0.0, dc)
 volatility = ql.BlackConstantVol(today, ql.TARGET(), vol, dc)
 
-# Black-Scholes process (pass objects directly)
+# Black-Scholes process
 process = ql.GeneralizedBlackScholesProcess(spot, dividend, risk_free, volatility)
 
-# European call option
-payoff = ql.PlainVanillaPayoff(ql.Call, 100.0)
+# European call option, 1 year to expiry
+payoff   = ql.PlainVanillaPayoff(ql.Call, 100.0)
 exercise = ql.EuropeanExercise(today + ql.Period("1Y"))
-option = ql.VanillaOption(payoff, exercise)
+option   = ql.VanillaOption(payoff, exercise)
 
 # Price with analytic Black-Scholes
 option.setPricingEngine(ql.AnalyticEuropeanEngine(process))
 
-print(f"NPV:   {option.NPV():.4f}")
-print(f"Delta: {option.delta():.4f}")
-print(f"Gamma: {option.gamma():.4f}")
-print(f"Vega:  {option.vega():.4f}")
-print(f"Theta: {option.theta():.4f}")
+print(f"NPV:   {option.NPV():.4f}")    # 10.4506
+print(f"Delta: {option.delta():.4f}")  # 0.6368
+print(f"Gamma: {option.gamma():.4f}")  # 0.0188
+print(f"Vega:  {option.vega():.4f}")   # 37.5240
+print(f"Theta: {option.theta():.4f}")  # -6.4140
 ```
 
-Output:
-```
-NPV:   10.4506
-Delta: 0.6368
-Gamma: 0.0188
-Vega:  37.5240
-Theta: -6.4140
-```
-
-## Module Organization
+## Module organization
 
 ```python
 import pyquantlib as ql          # Concrete classes
@@ -210,6 +171,20 @@ from pyquantlib.base import ...  # Abstract base classes (for subclassing)
 
 Coverage includes dates and calendars, market quotes, yield and volatility term structures, stochastic processes, instruments, and pricing engines. See the [API Reference](https://pyquantlib.readthedocs.io/en/latest/api/index.html) for the complete list.
 
+## Documentation
+
+Full documentation is available at [pyquantlib.readthedocs.io](https://pyquantlib.readthedocs.io/).
+
+| Section | Contents |
+|---------|----------|
+| [Quickstart](https://pyquantlib.readthedocs.io/en/latest/quickstart.html) | Installation and a first pricing example |
+| [Concepts](https://pyquantlib.readthedocs.io/en/latest/concepts/index.html) | Term structures, observables, engines, calibration, and the binding patterns behind them |
+| [Cookbook](https://pyquantlib.readthedocs.io/en/latest/cookbook/index.html) | Runnable recipes: curve bootstrapping, volatility surfaces, Heston calibration, NumPy interop |
+| [Examples](https://pyquantlib.readthedocs.io/en/latest/examples/index.html) | Jupyter notebooks, also available in [examples/](examples/) |
+| [API Reference](https://pyquantlib.readthedocs.io/en/latest/api/index.html) | Every bound class, by module |
+| [Architecture](https://pyquantlib.readthedocs.io/en/latest/architecture.html) | Design rationale and internals |
+| [Changelog](https://pyquantlib.readthedocs.io/en/latest/changelog.html) | Release history |
+
 ## Development
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
@@ -228,21 +203,8 @@ pip install -e .
 pytest
 ```
 
-## Documentation
-
-Full documentation is available at [pyquantlib.readthedocs.io](https://pyquantlib.readthedocs.io/). For the latest additions, see the [changelog](https://pyquantlib.readthedocs.io/en/latest/changelog.html).
-
-## Examples
-
-See the [examples](examples/) directory for Jupyter notebooks demonstrating PyQuantLib usage.
-
 ## License
 
 BSD 3-Clause License. See [LICENSE](LICENSE) for details.
 
-## Acknowledgments
-
-- [QuantLib](https://www.quantlib.org/) - Quantitative finance library
-- [pybind11](https://github.com/pybind/pybind11) - C++/Python bindings
-- [scikit-build-core](https://github.com/scikit-build/scikit-build-core) - Build system
-
+QuantLib is free software distributed under its own [modified BSD license](https://www.quantlib.org/license.shtml), and is copyright of its respective contributors.