From abf3019e8fa8e0c3f5a3bbd3b08076686a89bd14 Mon Sep 17 00:00:00 2001 From: Vinta Chen Date: Mon, 19 Oct 2026 13:02:46 +0800 Subject: [PATCH] docs: add soft length cap for entry lines Co-Authored-By: Claude --- CONTRIBUTING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e9fe3a82..502de273 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -53,6 +53,10 @@ Use the **PyPI package name** as the display name so developers can copy it dire - [pypi-name](https://github.com/owner/repo) - Description ending with period. ``` +### Description Length + +Aim for a rendered line of 100 characters or fewer: the name, ` - `, and the description, not counting the URL. Lines that long fit on one line in the GitHub README, which starts wrapping them around 105. This is a soft cap. When a draft lands near 105, cut filler words to get under it; when the content needs more room, let the line wrap rather than drop meaning. + ### Standard Library Module ```markdown