Skip to content

Docs: content capture + set_correlation API#26

Merged
deborahjacob-botanu merged 4 commits intomainfrom
developer
Apr 24, 2026
Merged

Docs: content capture + set_correlation API#26
deborahjacob-botanu merged 4 commits intomainfrom
developer

Conversation

@deborahjacob-botanu
Copy link
Copy Markdown
Collaborator

Summary

Changes

Type of change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update
  • CI / build / tooling

Testing

  • Unit tests pass (pytest)
  • Lint passes (ruff check)
  • Type check passes (mypy)

Checklist

  • My code follows the project's coding style
  • I have added SPDX headers to new files
  • I have added tests for my changes
  • I have updated documentation if needed
  • All commits are signed off (git commit -s) per the DCO

Replace @botanu_workflow / run_botanu / @botanu_outcome with
botanu.event() (context manager + async CM + decorator) and
botanu.step() for multi-phase events. event() lazy-calls enable()
so customers don't need a separate init step.

- Remove lean mode (full baggage is only mode; drop BAGGAGE_KEYS_LEAN,
  lean_mode param, propagation_mode field, BOTANU_PROPAGATION_MODE env)
- Remove emit_outcome(status=...) positional arg (diagnostic fields only)
- Drop ~440 LOC of legacy decorators + dead outcome.status checks
- Add lazy _ensure_enabled() on first event() call
- Rewrite all 20 SDK docs (Langfuse-style, each example self-contained)
- Fix to_baggage_dict docs: 5 always + 7 conditional keys
- Drop stale api_key field claim from BotanuConfig docs

417 tests pass, ruff clean.
@gitguardian
Copy link
Copy Markdown

gitguardian Bot commented Apr 24, 2026

⚠️ GitGuardian has uncovered 1 secret following the scan of your pull request.

Please consider investigating the findings and remediating the incidents. Failure to do so may lead to compromising the associated services or software components.

🔎 Detected hardcoded secret in your pull request
GitGuardian id GitGuardian status Secret Commit Filename
31556002 Triggered Bearer Token 9ebc4c6 tests/unit/test_pii.py View secret
🛠 Guidelines to remediate hardcoded secrets
  1. Understand the implications of revoking this secret by investigating where it is used in your code.
  2. Replace and store your secret safely. Learn here the best practices.
  3. Revoke and rotate this secret.
  4. If possible, rewrite git history. Rewriting git history is not a trivial act. You might completely break other contributing developers' workflow and you risk accidentally deleting legitimate data.

To avoid such incidents in the future consider


🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.

- README: rewrite quickstart around botanu.event(), drop enable() mention
- CHANGELOG: add Unreleased "Breaking" section for the event/step pivot
  and lean-mode removal; rewrite "Added" around the new API
- RELEASE: fix smoke-test script to use botanu.event()
- api/configuration.md: drop api_key field claim, fix to_baggage_dict
  description (5 always + 7 conditional, not "always 7")
- api/event.md: drop auto-enable note
- getting-started/configuration.md: drop enable() code examples,
  drop api_key field from BotanuConfig listing, drop "it calls enable()"
  note under zero-code init section
- getting-started/quickstart.md: drop enable() mention
- index.md: drop enable() mention
- integration/auto-instrumentation.md: reframe around first event() call
- integration/collector.md: drop enable() code example
- integration/existing-otel.md: reframe the whole page around
  "on first botanu.event() call" instead of "when you call enable()";
  drop brownfield/greenfield terminology for customer-facing copy
- patterns/anti-patterns.md: remove "Calling enable() repeatedly"
  anti-pattern section
- tracking/content-capture.md: drop enable() code example
Signed-off-by: deborahjacob-botanu <deborah@botanu.ai>
@deborahjacob-botanu deborahjacob-botanu merged commit 65b0b9c into main Apr 24, 2026
9 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant