Skip to content

docs: update README for v1.2.0, remove performance claims#112

Merged
FumingPower3925 merged 3 commits intomainfrom
docs/readme-update
Mar 31, 2026
Merged

docs: update README for v1.2.0, remove performance claims#112
FumingPower3925 merged 3 commits intomainfrom
docs/readme-update

Conversation

@FumingPower3925
Copy link
Copy Markdown
Contributor

Summary

  • Remove specific performance numbers from README (go stale; redirect to goceleris.dev/benchmarks)
  • Remove nonexistent Performance Profiles section and Objective config field
  • Add all v1.2.0 features to the Features list
  • Update Observability, API Overview, Feature Matrix, middleware list, and Project Structure
  • Bump Version constant from "1.0.0" to "1.2.0"

Changes

Removed:

  • Specific rps claims (3.3M H2, 590K H1) from Highlights
  • Benchmark results table and cloud methodology description
  • Performance Profiles section (celeris.Latency/Throughput/Balanced — never implemented)
  • Objective field from Config example

Added:

  • Link to goceleris.dev/benchmarks for current numbers
  • 8 new features in Features list (streaming, hijack, body limits, accept control, content negotiation, response buffering, zero-downtime restart, CPU monitoring)
  • CPUMonitor example in Observability section
  • 6 new types in API Overview (RouteInfo, Cookie, StreamWriter, EngineInfo, CPUMonitor, etc.)
  • 2 new rows in Feature Matrix (Detach/StreamWriter, Connection hijack)
  • celeristest/ in Project Structure
  • MaxRequestBodySize in Config example

Test plan

  • go build ./... clean
  • go vet ./... clean
  • All unit tests pass

- Remove specific performance numbers (3.3M rps, 590K rps, etc.) from
  Highlights and Benchmarks sections. Redirect to goceleris.dev/benchmarks
  for current numbers that won't go stale in the README.

- Remove nonexistent Performance Profiles section (celeris.Latency,
  celeris.Throughput, celeris.Balanced were never implemented).

- Remove nonexistent Objective field from Config example.

- Add v1.2.0 features to Features list: Streaming responses (Detach +
  StreamWriter), connection hijacking, MaxRequestBodySize, OnExpectContinue,
  PauseAccept/ResumeAccept, content negotiation, response buffering,
  zero-downtime restart, CPU utilization monitoring.

- Update Observability section with CPUMonitor example.

- Update API Overview table with new types: RouteInfo, Cookie,
  StreamWriter, EngineInfo, CPUMonitor.

- Update Feature Matrix with Detach/StreamWriter and connection hijack rows.

- Update middleware list with newly-unblocked middlewares (KeyAuth,
  ETag, Cache).

- Fix Project Structure: add celeristest/, fix internal/ subpackages,
  fix resource/ description (defaults, not objectives).

- Update bridge description to reference MaxRequestBodySize instead of
  hardcoded 100 MB.

- Bump Version constant from "1.0.0" to "1.2.0".
SECURITY.md:
- Bump supported version from >= 1.1.0 to >= 1.2.0
- Add note about known vulnerabilities in pre-1.2.0 versions (23 issues
  fixed during v1.2.0 security review: response splitting, cookie
  injection, null bytes, detach data leakage, request smuggling, etc.)
- Expand scope to cover new security surface areas (header sanitization,
  Detach lifecycle, body size enforcement, callback safety)
- Note that goceleris/middlewares has its own security policy

CONTRIBUTING.md:
- Add prerequisites: golangci-lint v2.9+, h2spec
- Add all current mage targets: spec, fuzz, check, benchLinux, etc.
- Add Linux Testing section with Multipass VM instructions
- Add Benchmarking section (localBenchmark, localProfile)
- Add Testing section with test organization conventions
- Add commit message format guidance (type: description, CWE references)
- Add hot-path code style note (no alloc, no defer for locks)
- Link to SECURITY.md for vulnerability reporting
@FumingPower3925 FumingPower3925 self-assigned this Mar 31, 2026
@FumingPower3925 FumingPower3925 merged commit fd48182 into main Mar 31, 2026
10 checks passed
@FumingPower3925 FumingPower3925 deleted the docs/readme-update branch March 31, 2026 13:01
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