about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJosh Triplett <josh@joshtriplett.org>2023-06-21 17:08:42 -0700
committerMichael Goulet <michael@errs.io>2023-07-05 21:40:19 +0000
commit5957f028a1019f306b131299e6e653d942f809e9 (patch)
treedb13aff3e97dd478f70ac71fe5eb747f446b97f7
parent5a6c618d1ab59139b602a3b07572a9fb056c94ec (diff)
downloadrust-5957f028a1019f306b131299e6e653d942f809e9.tar.gz
rust-5957f028a1019f306b131299e6e653d942f809e9.zip
style-guide: Add chapter for nightly formatting
Co-authored-by: Michael Goulet <michael@errs.io>
-rw-r--r--src/doc/style-guide/src/nightly.md8
1 files changed, 5 insertions, 3 deletions
diff --git a/src/doc/style-guide/src/nightly.md b/src/doc/style-guide/src/nightly.md
index 5a2815c71f1..031811b0e6f 100644
--- a/src/doc/style-guide/src/nightly.md
+++ b/src/doc/style-guide/src/nightly.md
@@ -1,3 +1,5 @@
-The style guide does not prescribe formatting for nightly-only syntax. Refer to
-the style team policy for nightly formatting procedure regarding breaking
-formatter changes and feature stabilization.
+This chapter documents style and formatting for nightly-only syntax. The rest of the style guide documents style for stable Rust syntax; nightly syntax only appears in this chapter. Each section here includes the name of the feature gate, so that searches (e.g. `git grep`) for a nightly feature in the Rust repository also turn up the style guide section.
+
+Style and formatting for nightly-only syntax should be removed from this chapter and integrated into the appropriate sections of the style guide at the time of stabilization.
+
+There is no guarantee of the stability of this chapter in contrast to the rest of the style guide. Refer to the style team policy for nightly formatting procedure regarding breaking changes to this chapter.