Update editor guide for embeds and documents in rich text, fix #4558 (#4632)

CHANGELOG.txt

@@ -19,6 +19,7 @@ Changelog
  * Added accessible colour contrast guidelines to the style guide (Catherine Farman)
  * Added faceted search using the `.facet()` method (Karl Hobley)
  * Admin modal views no longer rely on Javascript `eval()`, for better CSP compliance (Matt Westcott)
+ * Update editor guide for embeds and documents in rich text (Kevin Howbrook)
  * Fix: Handle all exceptions from `Image.get_file_size` (Andrew Plummer)
  * Fix: Fix display of breadcrumbs in ModelAdmin (LB (Ben Johnston))
  * Fix: Remove duplicate border radius of avatars (Benjamin Thurm)

CONTRIBUTORS.rst

@@ -310,6 +310,7 @@ Contributors
 * Abdulmalik Abdulwahab
 * Andrew Crewdson
 * Aram Dulyan
+* Kevin Howbrook
 
 Translators
 ===========

docs/editor_manual/new_pages/inserting_videos.rst

@@ -4,12 +4,15 @@
 Inserting videos into body content
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-As well as inserting videos into a carousel, Wagtail's rich text fields allow you to add videos into the body of a page by clicking the *Add video* button in the toolbar.
+It is possible to embed media into the body text of a web page by clicking the *Embed* button in rich text toolbar.
 
 .. image:: ../../_static/images/screen20_insert_video_form.png
 
-* Copy and paste the web address for the video (either YouTube or Vimeo) into the URL field and click Insert.
+* Copy and paste the web address for the media into the URL field and click Insert.
 
 .. image:: ../../_static/images/screen21_video_in_editor.png
 
-* A placeholder with the name of the video and a screenshot will be inserted into the text area. Clicking the X in the top corner will remove the video.
+* A placeholder of the media will be inserted into the text area.
+
+The embed button can be used to import media from a number of supported providers, you can see the `full list of supported providers in Wagtail’s source code <https://github.com/wagtail/wagtail/blob/master/wagtail/embeds/oembed_providers.py>`_.
+

docs/releases/2.2.rst

@@ -28,6 +28,7 @@ Other features
  * Added accessible colour contrast guidelines to the style guide (Catherine Farman)
  * Added faceted search using the ``.facet()`` method (Karl Hobley)
  * Admin modal views no longer rely on Javascript ``eval()``, for better CSP compliance (Matt Westcott)
+ * Update editor guide for embeds and documents in rich text (Kevin Howbrook)
 
 Bug fixes
 ~~~~~~~~~