Skip to content

docs: simplify verbose parameter descriptions in reference docs#12360

Open
nightcityblade wants to merge 1 commit intoaio-libs:masterfrom
nightcityblade:fix/issue-4127
Open

docs: simplify verbose parameter descriptions in reference docs#12360
nightcityblade wants to merge 1 commit intoaio-libs:masterfrom
nightcityblade:fix/issue-4127

Conversation

@nightcityblade
Copy link
Copy Markdown
Contributor

Fixes #4127

Shorten the :param: lines in the client and web reference docs and move the detailed explanations into the indented body below each parameter. This follows the maintainer suggestion from the issue and avoids the broken narrow "Parameters" column rendering caused by verbose inline parameter descriptions.

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 13, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.92%. Comparing base (1c472b5) to head (2483865).
⚠️ Report is 253 commits behind head on master.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##           master   #12360      +/-   ##
==========================================
+ Coverage   98.77%   98.92%   +0.14%     
==========================================
  Files         128      133       +5     
  Lines       44890    46550    +1660     
  Branches     2383     2423      +40     
==========================================
+ Hits        44340    46048    +1708     
+ Misses        390      373      -17     
+ Partials      160      129      -31     
Flag Coverage Δ
CI-GHA 98.98% <ø> (+0.35%) ⬆️
OS-Linux 98.72% <ø> (+0.34%) ⬆️
OS-Windows 96.98% <ø> (+0.26%) ⬆️
OS-macOS 97.88% <ø> (+0.27%) ⬆️
Py-3.10.11 97.39% <ø> (+0.23%) ⬆️
Py-3.10.19 ?
Py-3.10.20 97.86% <ø> (?)
Py-3.11.14 ?
Py-3.11.15 98.11% <ø> (?)
Py-3.11.9 97.65% <ø> (+0.27%) ⬆️
Py-3.12.10 97.73% <ø> (+0.27%) ⬆️
Py-3.12.12 ?
Py-3.12.13 98.19% <ø> (?)
Py-3.13.12 98.45% <ø> (+0.26%) ⬆️
Py-3.14.3 98.51% <ø> (+0.36%) ⬆️
Py-3.14.3t ?
Py-3.14.4t 97.51% <ø> (?)
Py-pypy3.11.13-7.3.20 ?
Py-pypy3.11.15-7.3.21 97.34% <ø> (?)
VM-macos 97.88% <ø> (+0.27%) ⬆️
VM-ubuntu 98.72% <ø> (+0.34%) ⬆️
VM-windows 96.98% <ø> (+0.26%) ⬆️
cython-coverage 38.22% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@codspeed-hq
Copy link
Copy Markdown

codspeed-hq bot commented Apr 13, 2026

Merging this PR will not alter performance

✅ 61 untouched benchmarks
⏩ 4 skipped benchmarks1


Comparing nightcityblade:fix/issue-4127 (2483865) with master (0c7ce34)

Open in CodSpeed

Footnotes

  1. 4 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

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.

Documentation formatting is... unusual

1 participant