Merge branch 'msj-permissions-comment' into 'master'

Add comment explaining permission table sorting

See merge request gitlab-org/gitlab!66856

doc/user/permissions.md

@@ -41,6 +41,8 @@ For more information, see [projects members documentation](project/members/index
 
 The following table lists project permissions available for each role:
 
+<!-- Keep this table sorted: first, by minimum role, then alphabetically. -->
+
 | Action                                            | Guest   | Reporter   | Developer   |Maintainer| Owner  |
 |---------------------------------------------------|---------|------------|-------------|----------|--------|
 | Create confidential issue                         | ✓       | ✓          | ✓           | ✓        | ✓      |
@@ -267,6 +269,8 @@ the group.
 
 The following table lists group permissions available for each role:
 
+<!-- Keep this table sorted: first, by minimum role, then alphabetically. -->
+
 | Action                                                 | Guest | Reporter | Developer | Maintainer | Owner |
 |--------------------------------------------------------|-------|----------|-----------|------------|-------|
 | Browse group                                           | ✓     | ✓        | ✓         | ✓          | ✓     |