Skip to content

docs: overhaul README to clarify wrapper nature and add telemetry disclosure#28

Merged
mldangelo merged 8 commits intomainfrom
docs/readme-overhaul
Feb 24, 2026
Merged

docs: overhaul README to clarify wrapper nature and add telemetry disclosure#28
mldangelo merged 8 commits intomainfrom
docs/readme-overhaul

Conversation

@mldangelo
Copy link
Member

Summary

  • Clarifies this repo is a wrapper — the README now prominently explains this is just a pip shim and directs users to promptfoo/promptfoo for all features, docs, and bugs
  • Adds telemetry disclosure — documents what is collected (anonymous ID, versions, email if logged in), where it goes (PostHog), and how to disable it (PROMPTFOO_DISABLE_TELEMETRY=1)
  • Removes marketing content — keeps docs focused and actionable; the main project's README handles the feature showcase
  • Updates contributing section — clearly splits where to file wrapper issues vs. promptfoo core issues

Test plan

  • README renders correctly on GitHub
  • Telemetry section is clear and accurate
  • All links work

renovate bot and others added 6 commits February 24, 2026 11:31
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael <michael.l.dangelo@gmail.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael <michael.l.dangelo@gmail.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael <michael.l.dangelo@gmail.com>
…closure

- Reframe repo as a thin pip wrapper pointing to promptfoo/promptfoo
  as the source of truth for all features and documentation
- Add telemetry disclosure section documenting what is collected,
  where it goes, and how to disable it (PROMPTFOO_DISABLE_TELEMETRY=1)
- Update version pinning docs now that PROMPTFOO_VERSION is implemented
- Simplify structure: less marketing copy, more actionable guidance
- Direct users to the main project for features/bugs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mldangelo mldangelo force-pushed the docs/readme-overhaul branch from 2004443 to 3960402 Compare February 24, 2026 19:31
mldangelo and others added 2 commits February 24, 2026 11:46
- Add telemetry section documenting what is collected and how to
  opt out (PROMPTFOO_DISABLE_TELEMETRY=1)
- Update contributing section to split wrapper issues (here) vs.
  promptfoo features/bugs (promptfoo/promptfoo) and link to CONTRIBUTING.md
- Remove unnecessary version pin from requirements.txt example
- Fix bare nodejs.org URL to markdown link

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mldangelo mldangelo merged commit a2302df into main Feb 24, 2026
@mldangelo mldangelo deleted the docs/readme-overhaul branch February 24, 2026 23:22
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