[TASK] Update "Create Content Elements" page (#187)

releases: main, 13.4

Co-authored-by: lina.wolf <[email protected]>

Documentation/ContentElements/CreatingContent/Index.rst

@@ -1,104 +1,129 @@
-.. include:: /Includes.rst.txt
+..  include:: /Includes.rst.txt
 
 
-.. _content-creating:
+..  _content-creating:
 
 ================
 Creating content
 ================
 
-..  youtube:: RuQ4CikixdY
-
-------------
-
 In the :guilabel:`Web > Page` module, on any page, click the :guilabel:`+
-Content` icon in the place where you want to insert content.
+Create new content` button in the place where you want to insert content:
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/CreateNew.png
-   :alt: Create a new Content Element by clicking the button
-   :class: with-shadow
+..  figure:: /Images/ManualScreenshots/NewContentElement/CreateNew.png
+    :alt: "Create new content button" in the Page module, column "Normal"
 
-   Create a new Content Element by clicking the button
+    Create a new Content Element by clicking the button
 
-The :guilabel:`Create new content element` window will then be displayed. The
-content elements that are available depend on the setup of your TYPO3
-installation and the extensions that are installed.
+The :guilabel:`New Page Content` wizard will then be displayed.
 
+..  contents:: Table of contents:
 
-.. _content-types:
+..  _content-types:
 
 Types of content elements
 =========================
 
-.. note::
-   If you are working with the `Introduction Package <https://extensions.typo3.org/extension/introduction/>`__, you will see more
-   content elements than described here. That's because the `Bootstrap Package <https://extensions.typo3.org/extension/bootstrap_package/>`__
-   (which is a dependency of the `Introduction Package <https://extensions.typo3.org/extension/introduction/>`__) comes with several content elements of its own.
+The content elements you can see here are provided by a standard TYPO3
+installation with a site package as described in the
+`TYPO3 site package tutorial <https://docs.typo3.org/permalink/t3sitepackage:start>`_.
+
+If you are working with a different setup you might see more, or different
+content elements.
+
+Which content elements you can see as an editor also depends on your user rights:
+
+A standard editor can see the following content elements:
+
+..  figure:: /Images/ManualScreenshots/ContentElements/WizardTypical.png
+    :alt: Screenshot of the "New Page Content" wizard as seen by a common TYPO3 editor, featuring "Typical Page Content", "Lists" and "Special elements"
+
+    Screenshot of the "New Page Content" wizard as seen by a common TYPO3 editor
 
-   This page describes the **TYPO3 Core** content elements.
+An advanced editor or an administrator can see the following content elements:
 
+..  figure:: /Images/ManualScreenshots/ContentElements/WizardAdvanced.png
+    :alt: Screenshot of the "New Page Content" wizard as seen by an advanced TYPO3 editor, additionally including "Form elements", "Menus" and additional "Special elements"
 
-.. _content-typical:
+    An advanced editor sees more groups and more content elements types in some of the groups
+
+..  _content-types-editor:
+
+Content elements seen by a typical TYPO3 editor
+===============================================
+
+..  _content-typical:
 
 Typical page content
 --------------------
 
 Insert regular text and image content types to build standard web pages.
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/WizardTabTypical.png
-   :alt: The 'Typical page content' tab of the new content element window
-   :class: with-shadow
+..  figure:: /Images/ManualScreenshots/NewContentElement/WizardTabTypical.png
+    :alt: 'Typical page content' tab contains content like Header, Regular Text Element, Text & Media, Images etc
+
+    The :guilabel:`Typical page content` tab of the new content element window
+
+..  _content-list:
+
+Lists
+-----
+
+Lists can be used for structured content. They provide less flexibility then
+standard content elements but are easier to use for their specialized use case.
 
-   The :guilabel:`Typical page content` tab of the new content element window
+..  figure:: /Images/ManualScreenshots/NewContentElement/WizardTabList.png
+    :alt: The 'List' tab contains content elements like "Bullet List", "Table" and "File Links"
 
+    The :guilabel:`List` tab of the new content element window
 
-.. _content-form:
+Depending on how the `Rendering is defined in the Site
+Package <https://docs.typo3.org/permalink/t3sitepackage:content-element-rendering>`_
+the way the results are displayed on the page might vary.
+
+..  _content-types-advanced:
+
+Advanced content elements
+=========================
+
+The following content elements are usually visible to advanced users:
+
+..  _content-form:
 
 Form elements
 -------------
 
 Create a login form or a simple contact form.
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/WizardTabForm.png
-   :alt: The 'Form elements' tab of the new content element window
-   :class: with-shadow
-
-   The :guilabel:`Form elements` tab of the new content element window
-
+..  figure:: /Images/ManualScreenshots/NewContentElement/WizardTabForm.png
+    :alt: Tab "Form elements" with "Form" and "Login Form"
 
+    The :guilabel:`Form elements` tab of the new content element window
 
-.. _content-menu:
+..  _content-menu:
 
 Menu elements
 -------------
 
 Present a menu or list of page links in different ways.
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/WizardTabMenu.png
-   :alt: The 'Menu' tab of the new content element window
-   :class: with-shadow
+..  figure:: /Images/ManualScreenshots/NewContentElement/WizardTabMenu.png
+    :alt: The 'Menu' tab of the new content element window
 
-   The :guilabel:`Menu` tab of the new content element window
+    The :guilabel:`Menu` tab of the new content element window
 
 
-.. _content-plugin:
+..  _content-plugin:
 
 Plugins
 -------
 
-Plugins are provided by extensions. Plugins that are available on this tab will
-depend on the individual plugin architecture or on the backend configuration.
-In some cases a plugin is made available by adding the "General Plugin" content
-element and then selecting the plugin itself on the :guilabel:`Plugin` tab.
+The tab "Plugins" is available if the integrator of your site installed an
+extension that provides a plugin in this section and you have the required user
+rights. Refer to the manual of the extension that provides the plugin for more
+information.
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/WizardTabPlugins.png
-   :alt: The 'Plugins' tab of the new content element window
-   :class: with-shadow
-
-   The :guilabel:`Plugins` tab of the new content element window
-
-
-.. _content-special:
+..  _content-special:
 
 Special elements
 ----------------
@@ -107,41 +132,44 @@ Insert plain HTML, or a horizontal divider on the page. The "Insert records"
 element lets you reference other content elements, i.e. reuse a content
 element from another page without duplicating it.
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/WizardTabSpecialElements.png
-   :alt: The 'Special elements' tab of the new content element window
-   :class: with-shadow
+..  figure:: /Images/ManualScreenshots/NewContentElement/WizardTabSpecialElements.png
+    :alt: The 'Special elements' tab of the new content element window
 
-   The :guilabel:`Plugins` tab of the new content element window
+    The :guilabel:`Plugins` tab of the new content element window
 
 
-.. _content-new-element:
+..  _content-new-element:
 
 Add new content to a page
 =========================
 
-#. On a page, click the :guilabel:`+ Content` icon in the place where you want
-   to insert content.
-#. On the :guilabel:`Typical Page Content` tab, choose the "Text & Media" element.
-   This is the most commonly used content type. The
-   :guilabel:`Create new Page Content` screen appears.
+#.  On a page, click the :guilabel:`+ Create new content` button in the area
+    where you want to insert content.
+#.  On the :guilabel:`Typical Page Content` tab, choose the "Text & Media" element.
+    This is the most commonly used content type. The
+    :guilabel:`Create new Page Content` form appears.
+
+..  figure:: /Images/ManualScreenshots/NewContentElement/NewContentElement.png
+    :alt: Create new Page Content on page "Page 1" form screenshot
+
+    Unsaved changes are highlighted in light blue
+
+#.  In the :guilabel:`Header` field, type *My new content element*.
+#.  In the :guilabel:`Text` area, type in some text. This field uses a
+    :ref:`Rich Text Editor<rte>` (RTE).
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/NewContentElement.png
-   :alt: Empty input form for a Text & Media content element
-   :class: with-shadow
+#.  Save and close the content element.
+    You can see the newly added element on the page:
 
-   Empty input form for a Text & Media content element
+..  figure:: /Images/ManualScreenshots/NewContentElement/ContentSaved.png
+    :alt: The new content element appears in the Page module
 
-#. In the :guilabel:`Header` field, type *My new content element*.
-#. In the :guilabel:`Text` area, type in some text. This field uses a
-   :ref:`Rich Text Editor<rte>` (RTE).
+    The new content element appears in the Page module
 
-#. Save and close the content element.
-   You can see the newly added element on the page:
+..  include:: /ContentElements/TipKeyboardCommands.rst.txt
 
-.. figure:: /Images/ManualScreenshots/NewContentElement/ContentSaved.png
-   :alt: The new content element appears in the Page module
-   :class: with-shadow
+Video of creating a content element (TYPO3 11.5)
+================================================
 
-   The new content element appears in the Page module
+..   youtube:: RuQ4CikixdY
 
-.. include:: /ContentElements/TipKeyboardCommands.rst.txt