Command naming conventions

danepowell · javiereguiluz · commit 60f8569b4aa1 · 2021-04-16T12:31:36.000+02:00
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
@@ -234,3 +234,11 @@ of the impacted component:
 This task is mandatory and must be done in the same pull request.
 
 .. _`@-silencing operator`: https://www.php.net/manual/en/language.operators.errorcontrol.php
+
+Naming Commands and Options
+---------------------------
+
+Commands and their options should be named and described using the English
+imperative mood (i.e. 'run' instead of 'runs', 'list' instead of 'lists'). Using
+the imperative mood is concise and consistent with similar command-line
+interfaces (such as Unix man pages).
