[DOCS] Add documentation for working with Linkvalidator

Information for working with Linkvalidator as editor
is added.

Resolves: #92718
Releases: master
Change-Id: I5c116c4561b91b2f8020f6803f6a1d50cd18a413
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/66275
Tested-by: TYPO3com <noreply@typo3.com>
Tested-by: Chris Müller <typo3@krue.ml>
Tested-by: Benni Mack <benni@typo3.org>
Reviewed-by: Chris Müller <typo3@krue.ml>
Reviewed-by: Benni Mack <benni@typo3.org>

typo3/sysext/linkvalidator/Documentation/Editors/Index.rst

@@ -0,0 +1,70 @@
+.. include:: /Includes.txt
+
+
+.. _editors:
+
+==========================
+Working with Linkvalidator
+==========================
+
+This page handles how to work with Linkvalidator as editor.
+It is intended for a non-technical audience.
+
+Linkvalidator Report
+====================
+
+#. First, select the page you want to work on in the page tree
+#. Access the Info module.
+#. In the top menu, select :guilabel:`Linkvalidator`.
+
+.. figure:: ../Images/EditorReports.png
+   :alt: Access Linkvalidator Report via Info module
+
+   Access Linkvalidator Report via Info module
+
+You will now see the :guilabel:`Report` with the list of broken links.
+In order to get results, select the checkboxes ("Internal Links",
+etc.) and choose the appropriate depth under :guilabel:`Show this level`.
+This will determine the page level, for example for depth :guilabel:`This page`,
+Linkvalidator will only show broken links for the page that is
+currently selected in the page tree. The deeper you go, the more
+broken links may possibly be shown. After you change the settings,
+you must click :guilabel:`Refresh display`.
+
+When you jump to a different page in the page tree, the :guilabel:`Report`
+will be refreshed.
+
+Listing of broken links
+=======================
+
+.. figure:: ../Images/ReportsTab.png
+   :alt: Linkvalidator Report with results
+
+   Linkvalidator Report with results
+
+The list shows the following, from left to right:
+
+#. **Element:** The title of the field which contains the broken link
+#. **Path:** The title of the page and its parents
+#. **Link:** The anchor text of the link
+#. **URL / Link target:** The link target, where the link points to.
+#. **Error message:** Information about the error. Often, this will be
+   a 404 error, which means the link target simply does not exist.
+#. **Last check:** When the broken link was detected
+#. The pencil icon can be used to edit the field where the broken
+   link exists.
+
+You can now fix the broken links one after another, by clicking on
+the pencil icon.
+
+The corresponding form will open. The broken link will be marked
+in a special style to make it visually stand out.
+
+.. figure:: ../Images/EditorEditField.png
+   :alt: Edit a field
+
+   Edit a field
+
+You can now double-click on it to open the Link Browser and fix the
+link. When you are done, click on save and close in order to
+return to the :guilabel:`Report`.

typo3/sysext/linkvalidator/Documentation/Index.rst

@@ -51,6 +51,7 @@ available from `typo3.org <https://typo3.org/>`_
    :glob:
 
    Introduction/Index
+   Editors/Index
    Administration/Index
    Configuration/Index
    LargeSites/Index