litestar-org/litestar

Docs: Add latency data to docs/benchmarks

Open

#2,548 opened on Oct 27, 2023

View on GitHub
 (2 comments) (0 reactions) (0 assignees)Python (550 forks)user submission
Documentation :books:Good First IssueHelp Wanted :sos:

Repository metrics

Stars
 (8,243 stars)
PR merge metrics
 (Avg merge 13h 27m) (26 merged PRs in 30d)

Description

Summary

The current docs page only reports Requests per second, which is definitely a very important metric for web frameworks. However, latency is also very important!

The current benchmarks suite already reports the latency details - it will be really nice if the results can be included in the docs.

Why not just let the reader run the benchmarks themselves?

  • running the benchmarks takes a long time
  • it doesn't work sometimes - I got several errors while running the benchmarks suite as-is

Basic Example

No response

Drawbacks and Impact

No response

Unresolved questions

No response

Contributor guide

Research direction
Review the existing benchmark results in the api performance tests repo and extract latency data for inclusion in the documentation.
Tech stack
python
Domain
backend
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Git
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75