[documentation/develop-kde-org] content/docs/getting-started/building: Add prominence to installing dependencies with kde-builder

Git commit 7541ef3a97303c1cef64c7d63c78394fe225c1c2 by Tomáš Hnyk.
Committed on 26/07/2026 at 21:47.
Pushed by thiagosueto into branch 'master'.

Add prominence to installing dependencies with kde-builder

The page about installing dependencies now does not mention at all that
you can install all dependencies for KDE using kde-builder. For people
not following the tutorial to set up kde-builder, this can be easily
missed. So this puts the link to the relevant kde-builder command into a
prominent position.

So that the link can be precise, "Set up kde-builder"
was split with subheadings. I also moved the note about contributing to
the --install-distro-packages command to the subheading about the
command, as it makes more sense this way.

The name of the subheading about compiling kcalc mentions Hello, World!,
as that is what this is about and is probably familiar to people.

M  +9    -1    content/docs/getting-started/building/help-dependencies/index.md
M  +9    -6    content/docs/getting-started/building/kde-builder-setup/index.md

https://invent.kde.org/documentation/develop-kde-org/-/commit/7541ef3a97303c1cef64c7d63c78394fe225c1c2

diff --git a/content/docs/getting-started/building/help-dependencies/index.md b/content/docs/getting-started/building/help-dependencies/index.md
index 13d8e4472..4cef055c5 100644
--- a/content/docs/getting-started/building/help-dependencies/index.md
+++ b/content/docs/getting-started/building/help-dependencies/index.md
@@ -6,8 +6,16 @@ group: "help"
 ---
 
 This page handles the normal issues related to missing dependencies when building with kde-builder. If you have any specific issues, consult our [Troubleshooting page]({{< ref "kde-builder-failure" >}}) or [contact the developers]({{< ref "help-developers" >}}).
- 
 
+{{< alert title="⚠️ Before proceeding" color="warning" >}}
+
+Make sure you have followed [Set up kde-builder]({{< ref "kde-builder-setup#set-up-kde-builder" >}}) in full and have installed the default package dependencies:
+
+```bash
+kde-builder --install-distro-packages
+```
+{{< /alert >}}
+ 
 ## How to install all the build dependencies of one package
 
 Often the simplest solution to the problem of missing dependencies is to automatically install all of the project's required dependencies.
diff --git a/content/docs/getting-started/building/kde-builder-setup/index.md b/content/docs/getting-started/building/kde-builder-setup/index.md
index 9a5f4d36a..a7e7142c2 100644
--- a/content/docs/getting-started/building/kde-builder-setup/index.md
+++ b/content/docs/getting-started/building/kde-builder-setup/index.md
@@ -132,12 +132,21 @@ sudo apt update
 
 {{< /alert >}}
 
+### Install dependencies
 During initial setup, `kde-builder` installed the essentials to run the tool itself. To install the distribution packages required to actually build KDE software, run:
 
 ```bash
 kde-builder --install-distro-packages
 ```
 
+{{< alert color="success" title="💡 A chance to contribute">}}
+
+If you discover any external dependencies needed to build KDE software that were not installed with `kde-builder --install-distro-packages`, for example using our guide on [Installing Build Dependencies]({{< ref "help-dependencies" >}}), please send a merge request to the [repo-metadata/distro-dependencies](https://invent.kde.org/sysadmin/repo-metadata/-/tree/master/distro-dependencies) repository to include the needed packages in the list.
+
+{{< /alert >}}
+
+### First build – Hello, World!
+
 Finally, perform your first build:
 
 ```shell
@@ -150,12 +159,6 @@ In the next section, [Building KDE software with kde-builder]({{< ref "kde-build
 
 `kde-builder` is now set up for building! 🎉
 
-{{< alert color="success" title="💡 A chance to contribute">}}
-
-If you discover any external dependencies needed to build KDE software that were not installed with `kde-builder --install-distro-packages`, for example using our guide on [Installing Build Dependencies]({{< ref "help-dependencies" >}}), please send a merge request to the [repo-metadata/distro-dependencies](https://invent.kde.org/sysadmin/repo-metadata/-/tree/master/distro-dependencies) repository to include the needed packages in the list.
-
-{{< /alert >}}
-
 ### Updating kde-builder
 
 You should occasionally update `kde-builder` to get its latest changes.