Skip to content

Overhaul README configuration docs - #16

Merged
craigpotter merged 1 commit into
mainfrom
docs/readme-overhaul
Jul 17, 2026
Merged

Overhaul README configuration docs#16
craigpotter merged 1 commit into
mainfrom
docs/readme-overhaul

Conversation

@craigpotter

Copy link
Copy Markdown
Collaborator

Overview of change

Documentation follow-up from #13/#15: the README previously documented queue support and the newer features but almost none of the config options. This PR:

  • Groups all configuration docs under a single Configuration section with subsections: enabling & disabling, choosing what gets recorded (only/ignore), keeping only failed responses, redacting sensitive request headers, excluding response bodies, response body limits, database connection, pruning, and queue support
  • Adds a short Requirements section (PHP 8.3+, Laravel 12+, Saloon v4)
  • Documents the placeholder values users see in the barstools table (REDACTED, <Streamed Body>, <Multipart Body>, <Unsupported Barstool Response Content>) and when each appears
  • Links the pruning setup from Installation instead of duplicating it there
  • Minor copy fixes, keeping the existing tone

One non-README change: the enabled config comment mentioned a UI that doesn't exist, so that mention is removed.

Testing

Docs only (plus a config comment) — full suite still green locally (31 passed, 154 assertions), Pint clean.

Documents all remaining config options - enabling/disabling, header
redaction, response body exclusion and limits, keep_successful_responses,
database connection, and pruning - grouped under a single Configuration
section with the existing only/ignore and queue docs. Adds a short
requirements section and documents the placeholder body values that
appear in the barstools table.

Also removes a mention of a non-existent UI from the config comment.
@craigpotter
craigpotter merged commit bbcd69d into main Jul 17, 2026
10 checks passed
@craigpotter
craigpotter deleted the docs/readme-overhaul branch July 17, 2026 23:43
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