docs: correct UTF-8 bucketing contract + real config/metrics endpoints
- Diagnostics.md / Roadmap.md: bucketing hashes UTF-8 bytes (value.encode("utf-8")),
not UTF-16 code units — matches the shipped code and JS/PHP parity contract.
- bucketing-algorithm.md: add the UTF-8 cross-SDK parity contract (seed 9999),
including non-ASCII visitor IDs, on the core bucketing page.
- api-communication.md: replace fictional cdn.convert.com / track.convert.com
examples with the real config CDN (/api/v1/config/{sdkKey}) and metrics endpoint
(https://[project_id].metrics.convertexperiments.com/v1/track/{sdkKey}, UA ConvertAgent/1.0).
Rewrite all Python-specific wiki pages from scratch against shipped SDK
Full from-scratch authoring of the 15 Python-specific pages, sourced from
src/convert_sdk (the __all__ public surface) and the test-verified docs/
(whose samples are executed by tests/test_docs_samples.py), rather than
editing the pre-finalization May-6 text.
Pages: Home, Quickstart, Installation, Initialization, Configuration,
CodeExamples, TypeHints, Diagnostics, Extending, Testing,
AsyncAndFrameworks, MigrationFromJavascript, MigrationFromRest, Roadmap,
ReleaseProcess.
Every import, symbol, method, field, and signature verified against the
SDK source; the MurmurHash3 parity assertion verified by execution.
Async/framework and Phase 3 content is explicitly labelled planned vs
shipped. Shared CI-synced docs left untouched.
Fix Python-specific pages to match shipped SDK public API
The Python-specific pages were authored 2026-05-06, before the SDK's
public API was finalized, and referenced fabricated/stale symbols.
Regenerated against src/convert_sdk (__all__) and the current docs/:
- Remove fabricated TrackingConfig — queue settings are SDKConfig fields
(batch_size, auto_flush_interval_ms).
- Remove fabricated GoalNotFoundError — goals surface via
ConversionResult/ConversionStatus.GOAL_NOT_FOUND and GoalDiagnostic.
- Remove fabricated LifecycleEventPayload — real payloads are
ConversionEventPayload and QueueReleasedPayload.
- Fix top-level imports that aren't exported (TrackingError, EventBus,
Transport) to their real submodule paths.
- Correct method/field drift: config_data=->data=, release_queues()->
flush(), set_default_segments->set_segments, force_multiple_transactions
->force_multiple, snapshot->current_config, diagnose_config_entity->
diagnose_entity, DataStore protocol get/set/has/delete, RefreshConfig
4-field surface, ExperienceResult fields.
Shared lowercase-kebab docs (CI-synced from backend) left untouched.
Initial wiki: shared Fullstack docs + Python-specific pages
Mirrors the JS and PHP SDK wiki structure:
- 15 Python-specific CamelCase pages (Home, Quickstart, Installation,
Initialization, Configuration, CodeExamples, TypeHints, Diagnostics,
Extending, Testing, AsyncAndFrameworks, MigrationFromJavascript,
MigrationFromRest, Roadmap, ReleaseProcess)
- 20 shared lowercase-kebab pages copied verbatim from the backend
full-stack-docs source (concepts/, guides/, integrations/llm-testing).
These will become CI-synced once convertcom/python-sdk is added to
backend/.github/workflows/sync-to-wikis.yml.
- Wiki infra: _Sidebar, _Footer, AI_Index, CLAUDE, sdk-docs-config.json.