about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorBarrett <contact@barretts.club>2024-10-08 17:05:10 -0500
committerTshepang Mbambo <tshepang@gmail.com>2024-11-05 09:22:17 +0200
commitf86fe2934f97f04c548e82295a666b2f65e8f2b0 (patch)
tree89e062d14ce077c96f06c6f3d6e60b7115936dcc /src/doc/rustc-dev-guide
parent27985c743f44e62bb8ad6da1ee6a75cbf292129c (diff)
downloadrust-f86fe2934f97f04c548e82295a666b2f65e8f2b0.tar.gz
rust-f86fe2934f97f04c548e82295a666b2f65e8f2b0.zip
diagnostics: lists should use the Oxford comma
we encountered this in https://github.com/rust-lang/rust/pull/131038

kinda felt like an unspoken rule so here's a more concrete
clarification.
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/diagnostics.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/diagnostics.md b/src/doc/rustc-dev-guide/src/diagnostics.md
index 5b6d1323f51..ddcaa8f331b 100644
--- a/src/doc/rustc-dev-guide/src/diagnostics.md
+++ b/src/doc/rustc-dev-guide/src/diagnostics.md
@@ -156,6 +156,8 @@ use an error-level lint instead of a fixed error.
   compiler messages are an important learning tool.
 - When talking about the compiler, call it `the compiler`, not `Rust` or
   `rustc`.
+- Use the [Oxford comma](https://en.wikipedia.org/wiki/Serial_comma) when
+  writing lists of items.
 
 ### Lint naming