--- a/mercurial/configitems.toml	Wed Dec 13 13:46:28 2023 +0100
+++ b/mercurial/configitems.toml	Mon Oct 09 15:06:21 2023 +0200
@@ -2489,6 +2489,18 @@
 default = false
 
 [[items]]
+section = "usage"
+name = "repository-role"
+default = "default"
+documentation = """What this repository is used for.
+
+This is used to adjust behavior and performance to best fit the repository purpose.
+
+Currently recognised values are:
+- default: an all purpose repository
+"""
+
+[[items]]
 section = "verify"
 name = "skipflags"
 default = 0

--- a/mercurial/helptext/config.txt	Wed Dec 13 13:46:28 2023 +0100
+++ b/mercurial/helptext/config.txt	Mon Oct 09 15:06:21 2023 +0200
@@ -2994,6 +2994,18 @@
     Increase the amount of output printed. (default: False)
 
 
+``usage``
+---------
+
+``repository-role``
+    What this repository is used for.
+
+    This is used to adjust behavior and performance to best fit the repository purpose.
+
+    Currently recognised values are:
+    - default: an all purpose repository
+
+
 ``command-templates``
 ---------------------