Release note and upgrade consideration for #1235

docs/releases/1.1.rst

@@ -15,6 +15,12 @@ What's new
 
 Usually, an operation that retrieves a queryset of pages (such as ``homepage.get_children()``) will return them as basic Page instances, which only include the core page data such as title. The ``specific()`` method (e.g. ``homepage.get_children().specific()``) now allows them to be retrieved as their most specific type, using the minimum number of queries.
 
+"Promoted search results" has moved into its own module
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously, this was implemented in :mod:`~wagtail.wagtailsearch` but now has
+been moved into a separate module: :mod:`wagtail.contrib.wagtailsearchpromotions`
+
 Minor features
 ~~~~~~~~~~~~~~
 
@@ -35,3 +41,23 @@ Bug fixes
  * Text areas in the non-default tab of the page editor now resize to the correct height
  * Tabs in "insert link" modal in the rich text editor no longer disappear (Tim Heap)
  * H2 elements in rich text fields were accidentally given a click() binding when put insite a collapsible multi field panel
+
+
+Upgrade considerations
+======================
+
+"Promoted search results" no longer in :mod:`~wagtail.wagtailsearch`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This feature has moved into a contrib module so is no longer enabled by default.
+
+To re-enable it, add :mod:`wagtail.contrib.wagtailsearchpromotions` to your ``INSTALLED_APPS``:
+
+.. code-block:: python
+
+    INSTALLED_APPS = [
+        ...
+
+        'wagtail.contrib.wagtailsearchpromotions',
+
+        ...