1 files changed, 8 insertions, 0 deletions

diff --git a/docs/dev/README.md b/docs/dev/README.md
index 5a9c0a148..46ee030fc 100644
--- a/docs/dev/README.md
+++ b/docs/dev/README.md
@@ -261,6 +261,14 @@ fn frobnicate(walrus: Option<Walrus>) {
 }
 ```
 
+## Commit Style
+
+We don't have specific rules around git history hygiene.
+Maintaining clean git history is encouraged, but not enforced.
+We use rebase workflow, it's OK to rewrite history during PR review process.
+
+Avoid @mentioning people in commit messages, as such messages create a lot of duplicate notification traffic during rebases.
+
 # Architecture Invariants
 
 This section tries to document high-level design constraints, which are not