--- a/doc/customizing.txt	Wed Apr 19 22:30:00 2023 -0400
+++ b/doc/customizing.txt	Sun Apr 23 12:33:31 2023 -0400
@@ -788,6 +788,12 @@
 number) we reduce the chance that someone mis-types a priority or
 status - or simply makes a new one up.
 
+Class names are used to access items of that class in the `REST api`_
+interface. The classic tracker was created before the REST interface
+was added. It uses the single form (i.e. issue and user not issues and
+users) for its classes. Most REST documentation suggests using plural
+forms. However, to make your API consistent, use singular forms for
+classes that you add.
 
 Class and Items
 ~~~~~~~~~~~~~~~