docs: enforce newlines when signature exceeds char threshold (#30866)

Below is an example of the single line vs new multiline approach.

Before this PR:

<img width="831" alt="Screenshot 2025-04-15 at 8 56 26 PM"
src="https://github.com/user-attachments/assets/0c0277bd-2441-4b22-a536-e16984fd91b7"
/>

After this PR:

<img width="829" alt="Screenshot 2025-04-15 at 8 56 13 PM"
src="https://github.com/user-attachments/assets/e16bfe38-bb17-48ba-a642-e8ff6b48e841"
/>
This commit is contained in:
Sydney Runkle 2025-04-16 08:45:40 -04:00 committed by GitHub
parent 4ff576e37d
commit 4af3f89a3a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -275,3 +275,7 @@ if os.environ.get("READTHEDOCS", "") == "True":
html_context["READTHEDOCS"] = True
master_doc = "index"
# If a signatures length in characters exceeds 60,
# each parameter within the signature will be displayed on an individual logical line
maximum_signature_line_length = 60