Deployed 4dd64a695 with MkDocs version: 1.4.0

about/release-notes/index.html

@@ -385,6 +385,8 @@ See <a href="../../user-guide/configuration/#edit_uri_template"><strong>document
 <h4 id="customize-event-order-for-plugin-event-handlers-2973">Customize event order for plugin event handlers (<a class="gh-link gh-issue" href="https://github.com/mkdocs/mkdocs/issues/2973" title="GitHub Issue mkdocs/mkdocs #2973">#2973</a>)<a class="headerlink" href="#customize-event-order-for-plugin-event-handlers-2973" title="Permanent link"></a></h4>
 <p>Plugins can now choose to set a priority value for their event handlers. This can override the old behavior where for each event type, the handlers are called in the order that their plugins appear in the <a href="../../user-guide/configuration/#plugins"><code>plugins</code> config</a>.</p>
 <p>If this is set, events with higher priority are called first. Events without a chosen priority get a default of 0. Events that have the same priority are ordered as they appear in the config.</p>
+<p>Recommended priority values: <code>100</code> "first", <code>50</code> "early", <code>0</code> "default", <code>-50</code> "late", <code>-100</code> "last".<br />
+As different plugins discover more precise relations to each other, the values should be further tweaked.</p>
 <p>See <a href="../../dev-guide/plugins/#event-priorities"><strong>documentation</strong></a>.</p>
 <h4 id="new-events-that-persist-across-builds-in-mkdocs-serve-2972">New events that persist across builds in <code>mkdocs serve</code> (<a class="gh-link gh-issue" href="https://github.com/mkdocs/mkdocs/issues/2972" title="GitHub Issue mkdocs/mkdocs #2972">#2972</a>)<a class="headerlink" href="#new-events-that-persist-across-builds-in-mkdocs-serve-2972" title="Permanent link"></a></h4>
 <p>The new events are <code>on_startup</code> and <code>on_shutdown</code>. They run at the very beginning and very end of an <code>mkdocs</code> invocation.<br />

index.html

@@ -342,5 +342,5 @@ configuration file. Start by reading the <a href="getting-started/">introductory
 
 <!--
 MkDocs version : 1.4.0
-Build Date UTC : 2022-09-27 17:28:02.837373+00:00
+Build Date UTC : 2022-09-27 18:02:10.784420+00:00
 -->