TYPO3-Documentation · linawolf · Jan 16, 2025 · Jan 16, 2025 · Jan 16, 2025
diff --git a/Documentation/CodingGuidelines/CodingBestPractices/Index.rst b/Documentation/CodingGuidelines/CodingBestPractices/Index.rst
diff --git a/Documentation/CodingGuidelines/Index.rst b/Documentation/CodingGuidelines/Index.rst
@@ -32,9 +32,7 @@ should be sufficient.
     :titlesonly:
 
     Introduction
-    PhpArchitecture/Index
     CglPhp/Index
-    CodingBestPractices/Index
     CglJavaScript/Index
     CglTypeScript/Index
     CglTypoScript/Index

diff --git a/Documentation/CodingGuidelines/PhpArchitecture/Index.rst b/Documentation/CodingGuidelines/PhpArchitecture/Index.rst
diff --git a/Documentation/Index.rst b/Documentation/Index.rst
@@ -40,6 +40,11 @@ TYPO3 Explained
         Learn how to write site packages and other custom extension with or
         without Extbase.
 
+    ..  card:: :ref:`PHP architecture <cgl-php-architecture>`
+
+        General PHP architectural strategies in TYPO3 core development and best
+        practices for extension developers.
+
     ..  card:: :ref:`Security guidelines <security>`
 
         This chapter describes some typical risks and advises how to protect a
@@ -60,6 +65,7 @@ TYPO3 Explained
     Configuration/Index
     CodingGuidelines/Index
     ExtensionArchitecture/Index
+    PhpArchitecture/Index
     Security/Index
     Testing/Index
 

diff --git a/Documentation/PhpArchitecture/Index.rst b/Documentation/PhpArchitecture/Index.rst
@@ -0,0 +1,29 @@
+..  include:: /Includes.rst.txt
+
+..  _cgl-modeling-cross-cutting-concerns:
+..  _cgl-php-architecture:
+..  _cgl-best-practices:
+
+================
+PHP architecture
+================
+
+Writing excellent PHP code within the TYPO3 framework involves more than just correctly
+utilizing the framework's API: It also requires making sound decisions regarding general
+PHP architecture.
+
+This chapter addresses general PHP architectural considerations and best
+practices, with a focus on TYPO3. It covers both overarching principles of
+good PHP architecture relevant to TYPO3 Core developers and best practices
+specifically for extension developers.
+
+..  toctree::
+    :maxdepth: 1
+    :titlesonly:
+
+    NamedArguments
+    Services
+    StaticMethods
+    Traits
+    WorkingWithExceptions
+    Singletons
diff --git a/...es/CodingBestPractices/NamedArguments.rst → ...tation/PhpArchitecture/NamedArguments.rst b/...es/CodingBestPractices/NamedArguments.rst → ...tation/PhpArchitecture/NamedArguments.rst
diff --git a/...ngGuidelines/PhpArchitecture/Services.rst → Documentation/PhpArchitecture/Services.rst b/...ngGuidelines/PhpArchitecture/Services.rst → Documentation/PhpArchitecture/Services.rst
diff --git a/...elines/CodingBestPractices/Singletons.rst → Documentation/PhpArchitecture/Singletons.rst b/...elines/CodingBestPractices/Singletons.rst → Documentation/PhpArchitecture/Singletons.rst
diff --git a/...delines/PhpArchitecture/StaticMethods.rst → ...ntation/PhpArchitecture/StaticMethods.rst b/...delines/PhpArchitecture/StaticMethods.rst → ...ntation/PhpArchitecture/StaticMethods.rst
diff --git a/...dingGuidelines/PhpArchitecture/Traits.rst → Documentation/PhpArchitecture/Traits.rst b/...dingGuidelines/PhpArchitecture/Traits.rst → Documentation/PhpArchitecture/Traits.rst
diff --git a/...PhpArchitecture/WorkingWithExceptions.rst → ...PhpArchitecture/WorkingWithExceptions.rst b/...PhpArchitecture/WorkingWithExceptions.rst → ...PhpArchitecture/WorkingWithExceptions.rst