update with results of commit MapServer/MapServer-documentation@4992d77

Author: MapServer deploybot

_sources/development/announce/8-6.txt

@@ -53,13 +53,13 @@ Binary Distributions
 
 Binary distributions will be available in the coming days:
 
-- Debian binaries of 8.6.0-beta1 are already available: https://tracker.debian.org/pkg/mapserver
+- Debian binaries of 8.6.0-beta2 are already available: https://tracker.debian.org/pkg/mapserver
 - `OSGeoLive <https://live.osgeo.org>`__ 17.0 release process is happening now, but
-  it will soon include MapServer 8.6.0-beta1
+  it will soon include MapServer 8.6.0-beta2
 - `UbuntuGIS <https://wiki.ubuntu.com/UbuntuGIS>`__ will follow the OSGeoLive
-  release and will then include MapServer 8.6.0-beta1
+  release and will then include MapServer 8.6.0-beta2
 - MS4W users have already been using branch-8-6 code, but watch for 
-  a new release shortly containing the 8.6.0-beta1 changes at: https://ms4w.com
+  a new release shortly containing the 8.6.0-beta2 changes at: https://ms4w.com
 
 .. TBD    
     - `RHEL and CentOS` TODO

ar/.doctrees/MIGRATION_GUIDE.doctree

@@ -153,7 +153,7 @@ <h3>Navigation</h3>
 <span id="migration"></span><h1><a class="toc-backref" href="#table-of-contents" role="doc-backlink">MapServer Migration Guide</a><a class="headerlink" href="#mapserver-migration-guide" title="Link to this heading">¶</a></h1>
 <dl class="field-list simple">
 <dt class="field-odd">Last Updated<span class="colon">:</span></dt>
-<dd class="field-odd"><p>2025-11-18</p>
+<dd class="field-odd"><p>2025-11-19</p>
 </dd>
 </dl>
 <nav class="contents" id="table-of-contents">
@@ -267,11 +267,41 @@ <h3>Navigation</h3>
 <p>original Pull Request <a class="reference external" href="https://github.com/MapServer/MapServer/pull/7309/">#7309</a></p>
 </div>
 </li>
-<li><p><a class="reference internal" href="ogc/ogc_api.html#ogcapi"><span class="std std-ref">OGC API : Features</span></a> has been enhanced to allow <cite>vendorSpecificParameters</cite> passed through to the OpenAPI
-document on the <cite>/items</cite> definitions.</p>
+<li><p><a class="reference internal" href="ogc/ogc_api.html#ogcapi"><span class="std std-ref">OGC API : Features</span></a> has been enhanced to allow the appending of additional
+query parameters to all URLs generated through the API, by
+defining the <cite>ows_extra_params</cite> parameter in the mapfile's WEB.METADATA object.</p>
+<blockquote>
+<div><div class="highlight-mapfile notranslate"><div class="highlight"><pre><span></span><span class="k">MAP</span>
+  <span class="p">...</span>
+  <span class="k">WEB</span>
+    <span class="k">METADATA</span>
+      <span class="s">&quot;ows_title&quot;</span> <span class="s">&quot;My OGCAPI Server&quot;</span>
+      <span class="p">...</span>
+      <span class="s">&quot;oga_html_template_directory&quot;</span> <span class="s">&quot;../../share/ogcapi/templates/html-bootstrap/&quot;</span>
+      <span class="s">&quot;ows_extra_params&quot;</span> <span class="s">&quot;token=123&quot;</span>
+    <span class="k">END</span> <span class="c">#metadata</span>
+  <span class="k">END</span> <span class="c">#web</span>
+  <span class="p">...</span>
+  <span class="k">LAYER</span>
+    <span class="p">...</span>
+  <span class="k">END</span> <span class="c">#layer</span>
+<span class="k">END</span> <span class="c">#map</span>
+</pre></div>
+</div>
+</div></blockquote>
+<p>All subsequent URLs available through OGCAPI: Features will contain that
+<cite>token=123</cite>, such as:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://127.0.0.1/cgi-bin/mapserv.exe/local-demo/ogcapi/collections/ocean/items?f=json&amp;token=123
+</pre></div>
+</div>
+<div class="admonition tip">
+<p class="admonition-title">نصيحة</p>
+<p>For sensitive parameter values, you should enable <a class="reference internal" href="cgi/runsub.html#runsub"><span class="std std-ref">Run-time Substitution</span></a> to
+not store passwords and other tokens in mapfiles.  See steps at <a class="reference internal" href="ogc/ogc_api.html#ogcapi-metadata"><span class="std std-ref">OGCAPI: Features metadata</span></a>.</p>
+</div>
 <div class="admonition seealso">
 <p class="admonition-title">شاهد أيضا</p>
-<p>original Pull Request <a class="reference external" href="https://github.com/MapServer/MapServer/pull/7295/">#7295</a></p>
+<p>original Pull Request <a class="reference external" href="https://github.com/MapServer/MapServer/pull/7360/">#7360</a></p>
 </div>
 </li>
 </ul>
@@ -1561,7 +1591,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="copyright.html">الحقوق</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-23.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

ar/.doctrees/development/announce/8-6.doctree

@@ -186,7 +186,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../copyright.html">الحقوق</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-23.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

ar/.doctrees/environment.pickle

@@ -5603,7 +5603,7 @@ <h3>Navigation</h3>
     </div>
     <div class="footer" role="contentinfo">
     &#169; <a href="../../copyright.html">الحقوق</a> 2025, Open Source Geospatial Foundation.
-      Last updated on 2025-11-18.
+      Last updated on 2025-11-23.
       Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
     </div>
   </body>

ar/.doctrees/mapscript/mapscript-api/stub/mapscript.shapeObj.doctree

@@ -6,7 +6,7 @@
 MapServer Migration Guide
 *****************************************************************************
 
-:Last Updated: 2025-11-18
+:Last Updated: 2025-11-19
 
 .. contents:: Table of Contents
     :depth: 2
@@ -101,10 +101,38 @@ MapServer 8.4 to 8.6 Migration
 
   .. seealso:: original Pull Request `#7309 <https://github.com/MapServer/MapServer/pull/7309/>`__  
 
-- :ref:`ogcapi` has been enhanced to allow `vendorSpecificParameters` passed through to the OpenAPI 
-  document on the `/items` definitions.
+- :ref:`ogcapi` has been enhanced to allow the appending of additional 
+  query parameters to all URLs generated through the API, by
+  defining the `ows_extra_params` parameter in the mapfile's WEB.METADATA object.
+  
+    .. code-block:: mapfile
+  
+      MAP
+        ...
+        WEB
+          METADATA
+            "ows_title" "My OGCAPI Server"
+            ...
+            "oga_html_template_directory" "../../share/ogcapi/templates/html-bootstrap/"
+            "ows_extra_params" "token=123"
+          END #metadata
+        END #web
+        ...
+        LAYER      
+          ...
+        END #layer
+      END #map
+      
+  All subsequent URLs available through OGCAPI: Features will contain that 
+  `token=123`, such as::
+  
+    http://127.0.0.1/cgi-bin/mapserv.exe/local-demo/ogcapi/collections/ocean/items?f=json&token=123
+    
+  .. TIP::
+     For sensitive parameter values, you should enable :ref:`Run-time Substitution <runsub>` to
+     not store passwords and other tokens in mapfiles.  See steps at :ref:`OGCAPI: Features metadata <ogcapi_metadata>`.
 
-  .. seealso:: original Pull Request `#7295 <https://github.com/MapServer/MapServer/pull/7295/>`__    
+  .. seealso:: original Pull Request `#7360 <https://github.com/MapServer/MapServer/pull/7360/>`__    
 
 .. _migration-8-4: