Clarify in docs that a high value corresponds to high extension priority (#756)

This fixes #755

1 files changed, 3 insertions, 2 deletions

diff --git a/docs/extensions/api.md b/docs/extensions/api.md
index c236a93..25a536d 100644
--- a/docs/extensions/api.md
+++ b/docs/extensions/api.md
@@ -564,8 +564,9 @@ registry: `register` and `deregister`. Use `register` to add items and
 `deregister` to remove items. See each method for specifics.
 
 When registering an item, a "name" and a "priority" must be provided. All
-items are automatically sorted by "priority" from highest to lowest. The
-"name" is used to remove (`deregister`) and get items.
+items are automatically sorted by the value of the "priority" parameter such
+that the item with the highest value will be processed first. The "name" is
+used to remove (`deregister`) and get items.
 
 A `Registry` instance is like a list (which maintains order) when reading
 data. You may iterate over the items, get an item and get a count (length)