Fix inaccuracies and add missing context to CLAUDE.md files

- Remove flake8 from linting list (not a pre-commit hook, only test dep)
- Add Docker info to Stack section
- Add auth env vars and CI matrix details to Testing section
- Fix docs deployment info: Read the Docs, not gh-deploy to GitHub Pages
- Add docs build output dir and autorefs cross-linking syntax
- Expand Windows socket isolation note in tests
- Add conftest.py location guide for tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: BryanFauble

CLAUDE.md

@@ -11,8 +11,9 @@ Synapse Python Client — official Python SDK and CLI for Synapse (synapse.org),
 - Models: stdlib dataclasses (NOT Pydantic)
 - Tests: pytest 8.2, pytest-asyncio, pytest-socket, pytest-xdist
 - Docs: MkDocs with Material theme, mkdocstrings
-- Linting: ruff, black (line-length 88), isort (profile=black), bandit, flake8
+- Linting: ruff, black (line-length 88), isort (profile=black), bandit
 - CI: GitHub Actions → SonarCloud, PyPI deploy on release
+- Docker: `Dockerfile` at repo root, published to `ghcr.io/sage-bionetworks/synapsepythonclient`
 
 ## Commands
 
@@ -108,3 +109,5 @@ Data flow: User → `operations/` factory → model async methods → `api/` ser
 - Unit test client fixture: session-scoped, `skip_checks=True`, `cache_client=False`
 - Integration tests use `--reruns 3` for flaky retries and `-n 8 --dist loadscope` for parallelism
 - Integration fixtures create per-worker Synapse projects; use `schedule_for_cleanup()` for teardown
+- Auth env vars: `SYNAPSE_AUTH_TOKEN` (bearer token), `SYNAPSE_PROFILE` (config file profile, default: `"default"`), `SYNAPSE_TOKEN_AWS_SSM_PARAMETER_NAME` (AWS SSM path)
+- CI runs integration tests only on Python 3.10 and 3.14 (oldest + newest) to limit Synapse server load

docs/CLAUDE.md

@@ -50,4 +50,6 @@ Defined in `mkdocs.yml` nav section. 5 main sections: Home, Tutorials, How-To Gu
 - Do not edit tutorial code inline in markdown — edit the `.py` script file in `tutorial_scripts/` and update line ranges if needed.
 - Reference docs auto-generate from source docstrings — to change method documentation, edit the docstring in the Python source, not the markdown.
 - `mkdocs.yml` is at the repo root, not in `docs/` — it configures the entire doc build.
-- Docs deploy via `mkdocs gh-deploy --force` targeting the `master` branch (not `develop`).
+- Docs deploy to Read the Docs (configured via `.readthedocs.yaml` at repo root).
+- Local build output goes to `docs_site/` (via `site_dir` in `mkdocs.yml`) — gitignored.
+- Cross-referencing uses the `autorefs` plugin: `[display text][synapseclient.ClassName.method]` auto-resolves to mkdocstrings anchors.

tests/CLAUDE.md

@@ -10,7 +10,7 @@ Test suite for the Synapse Python Client. Unit tests run without network access;
 Do not create synchronous test files. The `@async_to_sync` decorator is validated by a dedicated smoke test (`tests/integration/synapseclient/models/synchronous/test_sync_wrapper_smoke.py`). Duplicate sync tests were removed to cut CI cost and maintenance burden.
 
 ### Unit tests (`tests/unit/`)
-- `pytest-socket` blocks all network calls (unix sockets allowed on non-Windows for async event loop)
+- `pytest-socket` blocks all network calls (unix sockets allowed on non-Windows for async event loop). On Windows, socket disabling is skipped entirely — tests still run but are not network-isolated.
 - Session-scoped `syn` fixture: `Synapse(skip_checks=True, cache_client=False)` with silent logger
 - Autouse `set_timezone` fixture forces `TZ=UTC` for deterministic timestamps
 - Client caching disabled via `Synapse.allow_client_caching(False)`
@@ -25,6 +25,7 @@ Do not create synchronous test files. The `@async_to_sync` decorator is validate
 - `--reruns 3` for flaky retry, `-n 8 --dist loadscope` for parallelism
 - OpenTelemetry tracing opt-in via `SYNAPSE_INTEGRATION_TEST_OTEL_ENABLED` env var
 - Two client fixtures: `syn` (silent logger) and `syn_with_logger` (verbose)
+- conftest.py locations: `tests/unit/conftest.py` (session client, socket blocking, UTC timezone), `tests/integration/conftest.py` (logged-in client, per-worker projects, cleanup fixture)
 
 ### Test utilities
 - `tests/test_utils.py`: `spy_for_async_function(original_func)` — wraps async function for pytest-mock spying while preserving async behavior. `spy_for_function(original_func)` — sync variant.