From 084aa40e4eeb8cb7335208e13b814ab264467200 Mon Sep 17 00:00:00 2001
From: mamazu <14860264+mamazu@users.noreply.github.com>
Date: Sun, 10 Mar 2024 15:28:29 +0100
Subject: [PATCH 1/2] Adding documentation for the new webspaces

---
 book/localization.rst |  5 +++--
 book/webspaces.rst    | 30 ++++++++++++++++++++++++------
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/book/localization.rst b/book/localization.rst
index af261d46..9da4795c 100644
--- a/book/localization.rst
+++ b/book/localization.rst
@@ -14,9 +14,10 @@ Localizations for the content are configured in the webspaces, as already
 described in :doc:`webspaces`. Adding another localization is as easy as
 adding another ``localization`` tag to the webspace configuration file.
 Localizations can also be nested, which has no impact on the representation in
-all the dropdowns, but it will help the system to find better fallbacks.
+all the dropdowns, but it will help the system to find better fallbacks. This
+is why you can only nest them with a depth of 2.
 
-So a good example using english and german as a language might look something
+So a good example using English and German as a language might look something
 like the following fragment.
 
 .. code-block:: xml
diff --git a/book/webspaces.rst b/book/webspaces.rst
index 9d301cca..6a5e0b7f 100644
--- a/book/webspaces.rst
+++ b/book/webspaces.rst
@@ -11,19 +11,35 @@ administration interface. Sulu allows you to create pages and sub pages in
 these trees and fill them with content. Have a closer look at
 :doc:`templates` for more details on the content management process.
 
-Normally you'll create a webspace for a new website, a landingpage or a portal,
+Normally you'll create a webspace for a new website, a landing page or a portal,
 that should run on your Sulu instance.
 
-The following file shows a configuration. These lines will be explained in the
+To make working with configuration files easier Symfony Config provides some handy commands:
+
+.. code-block:: bash
+   # Creating a new webspace configuring template
+   bin/adminconsole config:dump-reference sulu_website --format xml
+
+   # Debugging the configuration
+   bin/adminconsole debug:config: sulu_website
+
+.. note::
+    All of the webspace definition files are located under `config/webspaces` and the default format is XML.
+
+The following file shows an example configuration written in XML. These lines will be explained in the
 following paragraphs.
 
 .. code-block:: xml
 
     <?xml version="1.0" encoding="utf-8"?>
-    <webspace xmlns="http://schemas.sulu.io/webspace/webspace"
-              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-              xsi:schemaLocation="http://schemas.sulu.io/webspace/webspace http://schemas.sulu.io/webspace/webspace-1.1.xsd">
-
+    <services:container xmlns="http://example.org/schema/dic/sulu_website"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xmlns:services="http://symfony.com/schema/dic/services"
+        xsi:schemaLocation="http://symfony.com/schema/dic/services
+            https://symfony.com/schema/dic/services/services-1.0.xsd"
+        >
+    <config>
+    <webspace>
         <name>Example</name>
         <key>example</key>
 
@@ -98,6 +114,8 @@ following paragraphs.
             </portal>
         </portals>
     </webspace>
+    </config>
+    </services:container>
 
 .. note::
 

From 87bd28bcafdcaf5b0889b26df6f9f001a06faaa7 Mon Sep 17 00:00:00 2001
From: mamazu <14860264+mamazu@users.noreply.github.com>
Date: Wed, 2 Oct 2024 18:50:11 +0200
Subject: [PATCH 2/2] Update book/webspaces.rst

---
 book/webspaces.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/book/webspaces.rst b/book/webspaces.rst
index 6a5e0b7f..57ef74b2 100644
--- a/book/webspaces.rst
+++ b/book/webspaces.rst
@@ -21,7 +21,7 @@ To make working with configuration files easier Symfony Config provides some han
    bin/adminconsole config:dump-reference sulu_website --format xml
 
    # Debugging the configuration
-   bin/adminconsole debug:config: sulu_website
+   bin/adminconsole debug:config sulu_website
 
 .. note::
     All of the webspace definition files are located under `config/webspaces` and the default format is XML.