From ec2c39e82ff851d8543d8c9ba56cc694d57910a5 Mon Sep 17 00:00:00 2001
From: Emerassi <78173681+Emerassi@users.noreply.github.com>
Date: Tue, 25 Nov 2025 16:00:25 -0800
Subject: [PATCH] Docs: Improve the documentation for priority locations to
 mention de-prioritized (#5631)

* Update the descriptions for priority and exclude locations to be more clear.

* Revision on priority

* Moved my change over to the documentation instead of the generated yaml comment.

* update per vi feedback

* Trying a 2 sentence approach

* more details!

* Update options api.md

* Update options api.md
---
 docs/options api.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/options api.md b/docs/options api.md
index 193d395342..7234d1cc49 100644
--- a/docs/options api.md	
+++ b/docs/options api.md	
@@ -269,7 +269,8 @@ placed on them.
 
 ### PriorityLocations
 Marks locations given here as `LocationProgressType.Priority` forcing progression items on them if any are available in
-the pool.
+the pool. Progression items without a deprioritized flag will be used first when filling priority_locations. Progression items with
+a deprioritized flag will be used next.
 
 ### ItemLinks
 Allows users to share their item pool with other players. Currently item links are per game. A link of one game between