PS-10735 [DOCS] - update compile-percona-server 8.4

	modified:   docs/compile-percona-server.md

Author: patrickbirch

docs/compile-percona-server.md

@@ -14,8 +14,7 @@ You can now fetch the latest Percona Server for MySQL {{vers}} sources.
 git clone https://github.com/percona/percona-server.git
 cd percona-server
 git checkout {{vers}}
-git submodule init
-git submodule update
+git submodule update --init
 ```
 
 If you are going to be making changes to Percona Server for MySQL {{vers}} and wanting
@@ -34,26 +33,51 @@ configure and build Percona Server for MySQL.
 First, run CMake to configure the build. Here you can specify all the normal
 build options as you do for a normal MySQL build. Depending on what
 options you wish to compile Percona Server for MySQL with, you may need other
-libraries installed on your system. Here is an example using a
-configure line similar to the options that Percona uses to produce
-binaries:
+libraries installed on your system.
+
+Note: `-DFEATURE_SET=community` is not supported in {{vers}}. If you use
+`-DFEATURE_SET=community`, CMake will report: *Manually-specified variables were not used by the project:
+FEATURE_SET*.
+
+Recommended — out-of-source build:
+
+```shell
+mkdir build
+cd build
+cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_CONFIG=mysql_release
+```
+
+On newer platforms or distros, if you hit compilation errors that are
+Linux-distro dependent, add `-DWITH_PACKAGE_FLAGS=OFF`:
 
 ```shell
-cmake . -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_CONFIG=mysql_release -DFEATURE_SET=community
+cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_CONFIG=mysql_release -DWITH_PACKAGE_FLAGS=OFF
+```
+
+Alternative — in-source build (quick one-time build only):
+
+For a one-off build you can use in-source configuration with
+`-DFORCE_INSOURCE_BUILD=1` instead of `FEATURE_SET`. The in-source build is a workaround;
+prefer the out-of-source build above.
+
+```shell
+cmake . -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_CONFIG=mysql_release -DFORCE_INSOURCE_BUILD=1
 ```
 
 ## Compile from source
 
-Now, compile using make:
+Compile using make with parallel jobs (run from the build directory if you used the out-of-source build):
 
 ```shell
-make
+make -j$(nproc)
 ```
 
 Install:
 
 ```shell
-make install
+make -j$(nproc) install
 ```
 
+`make` by default uses a single thread; using `-j$(nproc)` speeds up the build significantly.
+
 Percona Server for MySQL {{vers}} is installed on your system.