Ticket #21618: 21618-1.diff

docs/ref/contrib/gis/forms-api.txt

@@ -156 +156 @@
     This is the default widget used by all GeoDjango form fields.
     ``template_name`` is ``gis/openlayers.html``.
 
+    ``OpenLayersWidget`` and ``OSMWidget`` (described below) refer to the
+    ``openlayers.js`` file hosted on the http://openlayers.org Web site. This is
+    working for basic usage, but not necessarily convenient for your site in
+    production. You are therefore advised to subclass these widgets so as to be
+    able to specify your own version of the ``openlayers.js`` file in the ``js``
+    property of the inner ``Media`` class, either self-hosted and
+    `tailored to your needs`_ or from a content-delivery network
+    (http://cdnjs.com/, etc.). This will also allow you to serve the JavaScript
+    file(s) through the https protocol when needed.
+
+    .. _tailored to your needs: http://docs.openlayers.org/library/deploying.html
+
 ``OSMWidget``
 
 .. class:: OSMWidget
@@ -163 +175 @@
     This widget uses an OpenStreetMap base layer (Mapnik) to display geographic
     objects on.
     ``template_name`` is ``gis/openlayers-osm.html``.
+
+    The same note as above for ``OpenLayersWidget`` about JavaScript file
+    hosting applies here too. See also this `FAQ answer`_ about https access to
+    map tiles.
+
+    .. _FAQ answer: https://help.openstreetmap.org/questions/10920/how-to-embed-a-map-in-my-https-site