From 45c44da5e7b662020534416e2d63af02bb990e62 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 1 Dec 2024 16:52:38 +0100
Subject: [PATCH] [Backport 12.4] [TASK]  Add description of page TSconfig and
 user TSconfig in TYPO3 Concepts (#595)

* [TASK]  Add description of page TSconfig and user TSconfig in TYPO3 Concepts

#481

Releases: main, 13.4, 12.4

* Correct headline levels

* Make corrections

---------

Co-authored-by: Sarah McCarthy <sarahmccarthy123@yahoo.com>
Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>
---
 Documentation/Concepts/Index.rst          |  9 +++++
 Documentation/Concepts/TSconfig/Index.rst | 48 +++++++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 Documentation/Concepts/TSconfig/Index.rst

diff --git a/Documentation/Concepts/Index.rst b/Documentation/Concepts/Index.rst
index 50b8d86e..e12322a7 100644
--- a/Documentation/Concepts/Index.rst
+++ b/Documentation/Concepts/Index.rst
@@ -66,6 +66,14 @@ TYPO3 Concepts
         ..  card-footer:: :ref:`Create a minimal page created by pure TypoScript <typoscript>`
             :button-style: btn btn-secondary stretched-link
 
+    ..  card:: TSconfig
+
+        TSconfig is a configuration language used to configure the
+        TYPO3 backend. It has the same syntax as TypoScript.
+
+        ..  card-footer:: :ref:`TSconfig <tsconfig>`
+            :button-style: btn btn-secondary stretched-link
+
     ..  card:: Fluid templating
 
         Fluid is the standard templating engine that is used with TYPO3.
@@ -104,6 +112,7 @@ TYPO3 Concepts
     Extensions/Index
     Cache/Index
     TypoScript/Index
+    TSconfig/Index
     Fluid/Index
     TCA/Index
     Assets/Index
diff --git a/Documentation/Concepts/TSconfig/Index.rst b/Documentation/Concepts/TSconfig/Index.rst
new file mode 100644
index 00000000..24a19e6e
--- /dev/null
+++ b/Documentation/Concepts/TSconfig/Index.rst
@@ -0,0 +1,48 @@
+:navigation-title: TSconfig
+..  include:: /Includes.rst.txt
+
+..  _tsconfig:
+
+========
+TSConfig
+========
+
+There are two types of TSconfig: user TSconfig and page TSconfig.
+
+..  _concepts_user_tsconfig:
+
+User TSconfig
+=============
+
+User TSconfig is a set of configuration values that affect backend users. Best
+practice is to set them globally (in a site package TSconfig file) but they can
+also be set at the backend user or group level (then affecting all
+users in that group). Things that can be configured are generally related to
+permissions for basic functionality, for example, whether a user can clear the cache.
+
+There are also configuration values for the :ref:`TYPO3 Admin Panel <typo3/cms-adminpanel:start>`
+(which is shown in the frontend and not the backend).
+
+
+..  _concepts_page_tsconfig:
+
+Page TSconfig
+=============
+
+Page TSconfig is a set of configuration values that affect pages.  It is often
+set globally at the site level (in a site package TSconfig file) but can also be
+set at the page level and then affects that page and all the pages below it in
+the tree. The things that can be configured mainly affect the look and feel of the backend,
+such as which fields are available when editing a content element. In general,
+page TSconfig dictates what a user sees when they click on modules under `Web` in the
+left-hand module bar that open a pagetree, e.g. Page, View, List.
+
+..  _tsconfig-more-information:
+
+Where to find more information
+==============================
+
+To learn more about TSconfig and how to use it in your TYPO3 projects, refer to the official
+TYPO3 documentation:
+
+*   `Using and setting TSconfig <https://docs.typo3.org/permalink/t3tsref:typoscript-syntax-using-setting>`_