[Django] #37007: Extend contributor writing style section to counsel against the kinds of mistakes LLMs make

[Django]

#37007: Extend contributor writing style section to counsel against the kinds of
mistakes LLMs make
-------------------------------------+-------------------------------------
Reporter: Jacob | Owner: Jacob Walls
Walls |
Type: | Status: assigned
Cleanup/optimization |
Component: | Version: dev
Documentation |
Severity: Normal | Keywords: ai, llm, slop
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
Per [https://forum.djangoproject.com/t/discouraging-the-voice-from-
nowhere-llms-in-documentation/44699 forum discussion], add a few sentences
to the contributor writing style section with concrete guidance about how
to maintain the "voice" of the documentation.

This will allow reviewers to more simply reject & redirect contributors
submitting LLM-y prose without getting into debates about whether LLM use
is "permitted". More fundamentally, what's not permitted is polluting the
voice of the documentation.
--
Ticket URL: <https://code.djangoproject.com/ticket/37007>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37007: Extend contributor writing style section to counsel against the kinds of
mistakes LLMs make
-------------------------------------+-------------------------------------

Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:

Keywords: ai, llm, slop | Triage Stage:

| Unreviewed
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls):

* has_patch: 0 => 1

Comment:

[https://github.com/django/django/pull/21012 PR]
--
Ticket URL: <https://code.djangoproject.com/ticket/37007#comment:1>

[Django]

#37007: Extend contributor writing style section to counsel against the kinds of
mistakes LLMs make
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:

Keywords: ai, llm, slop | Triage Stage: Accepted

Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Natalia Bidart):

* stage: Unreviewed => Accepted

Comment:

Thank you!
--
Ticket URL: <https://code.djangoproject.com/ticket/37007#comment:2>

[Django]

#37007: Extend contributor writing style section to counsel against the kinds of
mistakes LLMs make
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: ai, llm, slop | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls):

* needs_better_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/37007#comment:3>

[Django]

#37007: Extend contributor writing style section to counsel against the kinds of
mistakes LLMs make
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: ai, llm, slop | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Jacob Walls):

* needs_better_patch: 1 => 0

--
Ticket URL: <https://code.djangoproject.com/ticket/37007#comment:4>