From bcf9686292ed40856771284996224d8d36035314 Mon Sep 17 00:00:00 2001
From: Laura Kassovic <lkassovic@gradle.com>
Date: Mon, 4 Dec 2023 09:14:27 -0800
Subject: [PATCH] update authoring section menu

---
 .../authoring_maintainable_build_scripts.adoc |  0
 .../organizing_gradle_projects.adoc           |  0
 .../authoring-builds/{ => other}/ant.adoc     |  0
 .../other}/build_services.adoc                |  0
 .../other}/custom_gradle_types.adoc           |  0
 .../other}/dataflow_actions.adoc              |  0
 .../{ => other}/test_kit.adoc                 |  0
 .../plugins}/custom_plugins.adoc              |  0
 .../plugins}/designing_gradle_plugins.adoc    |  0
 .../plugins}/implementing_gradle_plugins.adoc |  0
 .../plugins}/publishing_gradle_plugins.adoc   |  0
 .../plugins}/testing_gradle_plugins.adoc      |  0
 .../composite_builds.adoc                     |  0
 ...ring_dependencies_between_subprojects.adoc |  0
 .../fine_tuning_project_layout.adoc           |  0
 .../multi_project_builds.adoc                 |  0
 ...i_project_configuration_and_execution.adoc |  0
 ...aring_build_logic_between_subprojects.adoc |  0
 .../structuring_software_products.adoc        |  0
 ...structuring_software_products_details.adoc |  0
 .../tasks}/custom_tasks.adoc                  |  0
 .../tasks}/lazy_configuration.adoc            |  0
 .../{ => tasks}/more_about_tasks.adoc         |  0
 .../tasks}/task_configuration_avoidance.adoc  |  0
 .../tasks}/worker_api.adoc                    |  0
 .../docs/src/main/resources/header.html       | 40 ++++++++-----------
 26 files changed, 16 insertions(+), 24 deletions(-)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{ => best-practices}/authoring_maintainable_build_scripts.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{ => best-practices}/organizing_gradle_projects.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{ => other}/ant.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/other}/build_services.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/other}/custom_gradle_types.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/other}/dataflow_actions.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{ => other}/test_kit.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{developing-plugins => authoring-builds/plugins}/custom_plugins.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{developing-plugins => authoring-builds/plugins}/designing_gradle_plugins.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{developing-plugins => authoring-builds/plugins}/implementing_gradle_plugins.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{developing-plugins => authoring-builds/plugins}/publishing_gradle_plugins.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{developing-plugins => authoring-builds/plugins}/testing_gradle_plugins.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{software-product => structuring}/composite_builds.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{multi-project => structuring}/declaring_dependencies_between_subprojects.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{multi-project => structuring}/fine_tuning_project_layout.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{multi-project => structuring}/multi_project_builds.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{multi-project => structuring}/multi_project_configuration_and_execution.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{multi-project => structuring}/sharing_build_logic_between_subprojects.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{software-product => structuring}/structuring_software_products.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{software-product => structuring}/structuring_software_products_details.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/tasks}/custom_tasks.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/tasks}/lazy_configuration.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/authoring-builds/{ => tasks}/more_about_tasks.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/tasks}/task_configuration_avoidance.adoc (100%)
 rename platforms/documentation/docs/src/docs/userguide/{extending-gradle => authoring-builds/tasks}/worker_api.adoc (100%)

diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/authoring_maintainable_build_scripts.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/best-practices/authoring_maintainable_build_scripts.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/authoring_maintainable_build_scripts.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/best-practices/authoring_maintainable_build_scripts.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/organizing_gradle_projects.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/best-practices/organizing_gradle_projects.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/organizing_gradle_projects.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/best-practices/organizing_gradle_projects.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/ant.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/other/ant.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/ant.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/other/ant.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/build_services.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/other/build_services.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/build_services.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/other/build_services.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/custom_gradle_types.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/other/custom_gradle_types.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/custom_gradle_types.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/other/custom_gradle_types.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/dataflow_actions.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/other/dataflow_actions.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/dataflow_actions.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/other/dataflow_actions.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/test_kit.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/other/test_kit.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/test_kit.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/other/test_kit.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/developing-plugins/custom_plugins.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/custom_plugins.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/developing-plugins/custom_plugins.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/custom_plugins.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/developing-plugins/designing_gradle_plugins.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/designing_gradle_plugins.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/developing-plugins/designing_gradle_plugins.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/designing_gradle_plugins.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/developing-plugins/implementing_gradle_plugins.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/implementing_gradle_plugins.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/developing-plugins/implementing_gradle_plugins.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/implementing_gradle_plugins.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/developing-plugins/publishing_gradle_plugins.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/publishing_gradle_plugins.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/developing-plugins/publishing_gradle_plugins.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/publishing_gradle_plugins.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/developing-plugins/testing_gradle_plugins.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/testing_gradle_plugins.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/developing-plugins/testing_gradle_plugins.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/plugins/testing_gradle_plugins.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/software-product/composite_builds.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/composite_builds.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/software-product/composite_builds.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/composite_builds.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/declaring_dependencies_between_subprojects.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/declaring_dependencies_between_subprojects.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/declaring_dependencies_between_subprojects.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/declaring_dependencies_between_subprojects.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/fine_tuning_project_layout.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/fine_tuning_project_layout.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/fine_tuning_project_layout.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/fine_tuning_project_layout.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/multi_project_builds.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/multi_project_builds.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/multi_project_builds.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/multi_project_builds.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/multi_project_configuration_and_execution.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/multi_project_configuration_and_execution.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/multi_project_configuration_and_execution.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/multi_project_configuration_and_execution.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/sharing_build_logic_between_subprojects.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/sharing_build_logic_between_subprojects.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/multi-project/sharing_build_logic_between_subprojects.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/sharing_build_logic_between_subprojects.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/software-product/structuring_software_products.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/structuring_software_products.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/software-product/structuring_software_products.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/structuring_software_products.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/software-product/structuring_software_products_details.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/structuring_software_products_details.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/software-product/structuring_software_products_details.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/structuring/structuring_software_products_details.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/custom_tasks.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/custom_tasks.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/custom_tasks.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/custom_tasks.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/lazy_configuration.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/lazy_configuration.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/lazy_configuration.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/lazy_configuration.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/authoring-builds/more_about_tasks.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/more_about_tasks.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/authoring-builds/more_about_tasks.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/more_about_tasks.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/task_configuration_avoidance.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/task_configuration_avoidance.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/task_configuration_avoidance.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/task_configuration_avoidance.adoc
diff --git a/platforms/documentation/docs/src/docs/userguide/extending-gradle/worker_api.adoc b/platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/worker_api.adoc
similarity index 100%
rename from platforms/documentation/docs/src/docs/userguide/extending-gradle/worker_api.adoc
rename to platforms/documentation/docs/src/docs/userguide/authoring-builds/tasks/worker_api.adoc
diff --git a/platforms/documentation/docs/src/main/resources/header.html b/platforms/documentation/docs/src/main/resources/header.html
index cccde1a36207..6e5a9adca018 100644
--- a/platforms/documentation/docs/src/main/resources/header.html
+++ b/platforms/documentation/docs/src/main/resources/header.html
@@ -178,39 +178,19 @@ <h3 id="authoring-gradle-builds">Authoring Gradle Builds</h3>
                     <li><a href="../userguide/partr7_writing_plugins.html">7. Writing Plugins</a></li>
                 </ul>
             </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#authoring-introduction" aria-expanded="false" aria-controls="introduction">Other Topics</a>
-                <ul id="learning-the-basics">
-                    <li><a href="../userguide/directory_layout.html">Gradle managed Directories</a></li>
-                    <li><a href="../userguide/working_with_files.html">Working with Files</a></li>
-                    <li><a href="../userguide/logging.html">Working with Logging</a></li>
-                    <li><a href="../userguide/potential_traps.html">Avoiding Traps</a></li>
-                    <li><a href="../userguide/build_environment.html">Configuring the Build Environment</a></li>
-                    <li><a href="../userguide/init_scripts.html">Initialization Scripts</a></li>
-                </ul>
-            </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#authoring-multi-project-builds" aria-expanded="false" aria-controls="authoring-multi-project-builds">Structuring Individual Builds</a>
+            <li><a class="nav-dropdown" data-toggle="collapse" href="#authoring-multi-project-builds" aria-expanded="false" aria-controls="authoring-multi-project-builds">Structuring Builds</a>
                 <ul id="authoring-multi-project-builds">
                     <li><a href="../userguide/multi_project_builds.html">Creating a Basic Multi-Project Build</a></li>
                     <li><a href="../userguide/declaring_dependencies_between_subprojects.html">Declaring Dependencies between Subprojects</a></li>
                     <li><a href="../userguide/sharing_build_logic_between_subprojects.html">Sharing Build Logic between Subprojects</a></li>
                     <li><a href="../userguide/fine_tuning_project_layout.html">Fine Tuning the Project Layout</a></li>
                     <li><a href="../userguide/multi_project_configuration_and_execution.html">Understanding Configuration and Execution</a></li>
-                </ul>
-            </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#authoring-composite-builds" aria-expanded="false" aria-controls="authoring-composite-builds">Structuring Software Products</a>
-                <ul id="structuring-software-product">
                     <li><a href="../userguide/structuring_software_products.html">Structuring Large Projects</a></li>
                     <li><a href="../userguide/structuring_software_products_details.html">Tweaking Project Structure</a></li>
                     <li><a href="../userguide/composite_builds.html">Composing Builds</a></li>
                 </ul>
             </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#authoring-sustainable-builds" aria-expanded="false" aria-controls="authoring-sustainable-builds">Authoring Sustainable Builds</a>
-                <ul id="authoring-sustainable-builds">
-                    <li><a href="../userguide/organizing_gradle_projects.html">Organizing Build Logic</a></li>
-                    <li><a href="../userguide/authoring_maintainable_build_scripts.html">Following Best Practices</a></li>
-                </ul>
-            </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#developing-tasks" aria-expanded="false" aria-controls="developing-tasks">Developing Gradle Tasks</a>
+            <li><a class="nav-dropdown" data-toggle="collapse" href="#developing-tasks" aria-expanded="false" aria-controls="developing-tasks">Developing Tasks</a>
                 <ul id="developing-tasks">
                     <li><a href="../userguide/more_about_tasks.html">Authoring Tasks</a></li>
                     <li><a href="../userguide/custom_tasks.html">Writing Gradle Task Types</a></li>
@@ -219,7 +199,7 @@ <h3 id="authoring-gradle-builds">Authoring Gradle Builds</h3>
                     <li><a href="../userguide/worker_api.html">Developing Parallel Tasks</a></li>
                 </ul>
             </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#developing-plugins" aria-expanded="false" aria-controls="developing-plugins">Developing Gradle Plugins</a>
+            <li><a class="nav-dropdown" data-toggle="collapse" href="#developing-plugins" aria-expanded="false" aria-controls="developing-plugins">Developing Plugins</a>
                 <ul id="developing-plugins">
                     <li><a href="../userguide/custom_plugins.html">Starting Plugin Development</a></li>
                     <li><a href="../userguide/designing_gradle_plugins.html">Designing Plugins</a></li>
@@ -228,8 +208,20 @@ <h3 id="authoring-gradle-builds">Authoring Gradle Builds</h3>
                     <li><a href="../userguide/publishing_gradle_plugins.html">Publishing Plugins</a></li>
                 </ul>
             </li>
-            <li><a class="nav-dropdown" data-toggle="collapse" href="#other-developing-topics" aria-expanded="false" aria-controls="other-developing-topics">Other Developing Gradle Topics</a>
+            <li><a class="nav-dropdown" data-toggle="collapse" href="#authoring-sustainable-builds" aria-expanded="false" aria-controls="authoring-sustainable-builds">Best Practices</a>
+                <ul id="authoring-sustainable-builds">
+                    <li><a href="../userguide/organizing_gradle_projects.html">Organizing Build Logic</a></li>
+                    <li><a href="../userguide/authoring_maintainable_build_scripts.html">Following Best Practices</a></li>
+                </ul>
+            </li>
+            <li><a class="nav-dropdown" data-toggle="collapse" href="#other-developing-topics" aria-expanded="false" aria-controls="other-developing-topics">Other Topics</a>
                 <ul id="other-developing-topics">
+                    <li><a href="../userguide/directory_layout.html">Gradle managed Directories</a></li>
+                    <li><a href="../userguide/working_with_files.html">Working with Files</a></li>
+                    <li><a href="../userguide/logging.html">Working with Logging</a></li>
+                    <li><a href="../userguide/potential_traps.html">Avoiding Traps</a></li>
+                    <li><a href="../userguide/build_environment.html">Configuring the Build Environment</a></li>
+                    <li><a href="../userguide/init_scripts.html">Initialization Scripts</a></li>
                     <li><a href="../userguide/custom_gradle_types.html">Writing Custom Gradle Types and Service Injection</a></li>
                     <li><a href="../userguide/build_services.html">Shared Build Services</a></li>
                     <li><a href="../userguide/dataflow_actions.html">Dataflow Actions</a></li>