sponsor section in README.md and tables of contents

Author: SidRichardsQuantum

README.md

@@ -32,6 +32,29 @@ Implemented packages:
 - `qite` for projected variational dynamics (`VarQITE`, `VarQRTE`)
 - `common` for shared chemistry, Hamiltonians, caching, and plotting
 
+## Table of Contents
+
+- [What This Repo Is Good For](#what-this-repo-is-good-for)
+- [Choose A Method](#choose-a-method)
+- [Install](#install)
+- [Quickstart](#quickstart)
+- [Typical Workflow](#typical-workflow)
+- [Package Overview](#package-overview)
+  - [vqe](#vqe)
+  - [qpe](#qpe)
+  - [qite](#qite)
+- [Shared Infrastructure](#shared-infrastructure)
+- [Supported Molecule Inputs](#supported-molecule-inputs)
+- [Non-Molecule Mode](#non-molecule-mode)
+- [Outputs And Reproducibility](#outputs-and-reproducibility)
+- [Notebooks](#notebooks)
+- [Documentation](#documentation)
+- [Repository Layout](#repository-layout)
+- [Testing](#testing)
+- [Support Development](#support-development)
+- [Author](#author)
+- [License](#license)
+
 ## What This Repo Is Good For
 
 Use this repo if you want:
@@ -357,6 +380,24 @@ Variational_Quantum_Eigensolver/
 pytest -q
 ```
 
+---
+
+## Support development
+
+If this repository is useful for research, learning, or experimentation, you can support continued development via GitHub Sponsors:
+
+https://github.com/sponsors/SidRichardsQuantum
+
+Sponsorship helps support ongoing work on open-source implementations of quantum algorithms, including improvements to documentation, reproducible workflows, and example notebooks.
+
+Support helps maintain and expand practical tooling for variational quantum methods, quantum simulation workflows, and related experimentation.
+
+## Citation
+
+Sid Richards (2026)
+
+Unified Variational and Phase-Estimation Quantum Simulation Suite
+
 ## Author
 
 Sid Richards

THEORY.md

@@ -788,5 +788,13 @@ PennyLane documentation for:
 
 ---
 
-Author: Sid Richards
-License: MIT
+## Author
+
+Sid Richards
+
+- LinkedIn: [sid-richards-21374b30b](https://www.linkedin.com/in/sid-richards-21374b30b/)
+- GitHub: [SidRichardsQuantum](https://github.com/SidRichardsQuantum)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

USAGE.md

@@ -9,6 +9,50 @@ Workflows and APIs for:
 
 ---
 
+## Table of Contents
+
+- [Documentation Map](#documentation-map)
+- [Core Execution Model](#core-execution-model)
+- [Supported Molecule Inputs](#supported-molecule-inputs)
+- [Installation](#installation)
+- [General Conventions](#general-conventions)
+- [Method Support Summary](#method-support-summary)
+- [Quickstart](#quickstart)
+
+- [VQE Workflows](#vqe-workflows)
+  - [Basic VQE](#basic-vqe)
+  - [Non-molecule expert mode](#non-molecule-expert-mode)
+  - [Ansatz selection](#ansatz-selection)
+  - [Optimizer selection](#optimizer-selection)
+  - [Geometry scans](#geometry-scans)
+  - [Noise studies](#noise-studies)
+  - [Low-qubit benchmark](#low-qubit-benchmark)
+
+- [Excited-State Methods](#excited-state-methods)
+  - [Post-VQE methods](#post-vqe-methods)
+  - [Variational excited states](#variational-excited-states)
+
+- [QPE](#qpe)
+  - [Basic QPE](#basic-qpe)
+  - [Noise](#noise)
+  - [Time evolution controls](#time-evolution-controls)
+
+- [QITE / Projected Dynamics](#qite--projected-dynamics)
+  - [Execution modes](#execution-modes)
+  - [Run](#run)
+  - [Real-time run](#real-time-run)
+  - [Noisy evaluation](#noisy-evaluation)
+  - [Noise sweep](#noise-sweep)
+  - [Cache semantics](#cache-semantics)
+
+- [Reproducibility](#reproducibility)
+- [Testing](#testing)
+- [Citation](#citation)
+- [Author](#author)
+- [License](#license)
+
+---
+
 ## Documentation Map
 
 | File                        | Purpose                        |
@@ -812,7 +856,13 @@ Sid Richards (2026)
 
 Unified Variational and Phase-Estimation Quantum Simulation Suite
 
----
+## Author
+
+Sid Richards
+
+- LinkedIn: [sid-richards-21374b30b](https://www.linkedin.com/in/sid-richards-21374b30b/)
+- GitHub: [SidRichardsQuantum](https://github.com/SidRichardsQuantum)
+
+## License
 
-Author: Sid Richards
-License: MIT
+MIT. See [LICENSE](LICENSE).

more_docs/vqe/noise.md

@@ -155,9 +155,9 @@ vqe -m H2 --noisy --depolarizing-prob 0.02
 
 Behaviour:
 
-* noise applied independently to each qubit
-* any subset of built-in channels can be combined
-* ignored if `--noisy` is not set
+- noise applied independently to each qubit
+- any subset of built-in channels can be combined
+- ignored if `--noisy` is not set
 
 ---
 
@@ -186,18 +186,18 @@ apply_optional_noise(..., noise_model=my_noise)
 
 Behaviour:
 
-* applied **after the ansatz**
-* executed only if `noisy=True`
-* can include arbitrary PennyLane channels
+- applied **after the ansatz**
+- executed only if `noisy=True`
+- can include arbitrary PennyLane channels
 
 ---
 
 ### Combined behaviour
 
 If both interfaces are used:
 
-* built-in configured channels are applied first
-* then `noise_model` is applied
+- built-in configured channels are applied first
+- then `noise_model` is applied
 
 This allows explicit package-supported channels plus arbitrary extra PennyLane channels.
 
@@ -213,13 +213,13 @@ apply_optional_noise(...)
 
 ### Key properties
 
-* no-op if `noisy=False`
-* applied to all wires:
+- no-op if `noisy=False`
+- applied to all wires:
 
   ```python
   wires = list(range(num_wires))
   ```
-* applied **inside QNodes**, after ansatz construction
+- applied **inside QNodes**, after ansatz construction
 
 ---
 
@@ -257,8 +257,8 @@ Differentiation method depends on noise:
 
 Reason:
 
-* parameter-shift is not generally valid for noisy channels
-* finite-difference is used as a fallback
+- parameter-shift is not generally valid for noisy channels
+- finite-difference is used as a fallback
 
 ---
 
@@ -268,47 +268,47 @@ Noise affects different methods differently.
 
 ### Fully supported
 
-* VQE
-* ADAPT-VQE
-* SSVQE
-* VQD
-* QPE (via noisy evolution)
+- VQE
+- ADAPT-VQE
+- SSVQE
+- VQD
+- QPE (via noisy evolution)
 
 ---
 
 ### Partially supported
 
-* QITE / VarQITE
+- QITE / VarQITE
 
-  * optimization: noiseless
-  * evaluation: noisy (post-processing)
+  - optimization: noiseless
+  - evaluation: noisy (post-processing)
 
 ---
 
 ### Not supported (noiseless-only)
 
-* LR-VQE
-* EOM-VQE
-* QSE
-* EOM-QSE
+- LR-VQE
+- EOM-VQE
+- QSE
+- EOM-QSE
 
 Reason:
 
-* require statevector access
-* rely on exact overlaps or tangent vectors
+- require statevector access
+- rely on exact overlaps or tangent vectors
 
 ---
 
 ## Overlap Handling Under Noise
 
 For methods like VQD:
 
-* noiseless:
+- noiseless:
   [
   |\langle \psi_i | \psi_j \rangle|^2
   ]
 
-* noisy:
+- noisy:
   [
   \mathrm{Tr}(\rho_i \rho_j)
   ]
@@ -323,42 +323,42 @@ Noise impacts:
 
 ### 1. Energy estimation
 
-* increases variance
-* introduces bias
-* reduces achievable accuracy
+- increases variance
+- introduces bias
+- reduces achievable accuracy
 
 ---
 
 ### 2. Optimization
 
-* flattens gradients
-* introduces stochastic behaviour
-* may slow convergence
+- flattens gradients
+- introduces stochastic behaviour
+- may slow convergence
 
 ---
 
 ### 3. Circuit expressibility
 
-* reduces effective expressibility
-* limits reachable states
+- reduces effective expressibility
+- limits reachable states
 
 ---
 
 ### 4. Excited-state methods
 
-* post-VQE methods typically break under noise
-* variational methods remain usable
+- post-VQE methods typically break under noise
+- variational methods remain usable
 
 ---
 
 ## Practical Guidance
 
-* use small noise levels first:
+- use small noise levels first:
 
-  * e.g. `0.01 – 0.05`
-* compare against noiseless baseline
-* reduce stepsize when noise is high
-* use multi-seed runs for statistical analysis:
+  - e.g. `0.01 – 0.05`
+- compare against noiseless baseline
+- reduce stepsize when noise is high
+- use multi-seed runs for statistical analysis:
 
   ```bash
   vqe --multi-seed-noise
@@ -368,10 +368,10 @@ Noise impacts:
 
 ## Limitations
 
-* noise is applied **after the full ansatz**, not per gate
-* no time-dependent noise modeling
-* no hardware-specific calibration
-* no error mitigation techniques included
+- noise is applied **after the full ansatz**, not per gate
+- no time-dependent noise modeling
+- no hardware-specific calibration
+- no error mitigation techniques included
 
 ---
 
@@ -392,8 +392,8 @@ Noise impacts:
 
 Noise is treated as a **modular, post-ansatz layer**:
 
-* simple to use via CLI
-* extensible via custom models
-* integrated consistently across VQE workflows
+- simple to use via CLI
+- extensible via custom models
+- integrated consistently across VQE workflows
 
 This design enables controlled studies of noise effects without modifying algorithm implementations.