Improves documentation

 * Describes better available source tree sharing method (between
xds-agent and xds-server), and which to prefer depending on the
deployment setup.
 * Gives indication about how to pass RSYNC_TARGET and RSYNC_PREFIX
 env vars to the helloworld-native-application build process.
 * Swap chapter order (build before config)

Bug: SPEC-1993

Change-Id: Ie4c22f277a59b0405744d71b0fadff67c5d5d025
Signed-off-by: Sebastien Douheret <sebastien.douheret@iot.bzh>

15 files changed, 15 insertions, 14 deletions

diff --git a/docs/part-2/1_xds-server/0_abstract.md b/docs/part-2/1_xds-server/0_abstract.md
index 07dd057..8e8d9a4 100644
--- a/docs/part-2/1_xds-server/0_abstract.md
+++ b/docs/part-2/1_xds-server/0_abstract.md
@@ -35,7 +35,8 @@ IDE (such as Netbeans or Visual Studio Code) through `xds-agent <=> xds-server`.
 
 Links to subchapters :
 
-- [Configuration](./1_config.html)
-- [How to run](./2_how-to-run.html)
-- [Build from scratch](./3_build.html)
+- [Build from scratch](./1_build.html)
+- [Configuration](./2_config.html)
+- [How to run](./3_how-to-run.html)
 - [Debugging](./4_debug.html)
+- [Tests](./5_test.html)
diff --git a/docs/part-2/1_xds-server/3_build.md b/docs/part-2/1_xds-server/1_build.md
index 5c5059f..5c5059f 100644
--- a/docs/part-2/1_xds-server/3_build.md
+++ b/docs/part-2/1_xds-server/1_build.md
diff --git a/docs/part-2/1_xds-server/1_config.md b/docs/part-2/1_xds-server/2_config.md
index ad86043..ad86043 100644
--- a/docs/part-2/1_xds-server/1_config.md
+++ b/docs/part-2/1_xds-server/2_config.md
diff --git a/docs/part-2/1_xds-server/2_how-to-run.md b/docs/part-2/1_xds-server/3_how-to-run.md
index a3ae22b..4e56f3f 100644
--- a/docs/part-2/1_xds-server/2_how-to-run.md
+++ b/docs/part-2/1_xds-server/3_how-to-run.md
@@ -118,7 +118,7 @@ See also [xds-agent documentation](../2_xds-agent/0_abstract.html) for more deta
 <!-- end-section-note -->
 
 `xds-server` dynamically detects supported SDKs by scanning sub-directories of
-`sdkScriptsDir` directory (see [Configuration chapter](1_config.html)).
+`sdkScriptsDir` directory (see [Configuration chapter](2_config.html)).
 
 Each sub-directory (usually name is the same as the SDK family) of `sdkScriptsDir`
 must contain a set of scripts that will be called by `xds-server` to managed SDKs
@@ -159,7 +159,7 @@ On startup `xds-server` will call in order:
 
 - `sdks/*/get-family-config` to get configuration of each SDK family.
 - `sdks/*/db-update` to update database (only when `SdkDbUpdate` is set to ̀`startup`,
-   see [Configuration chapter](1_config.html) for more details)
+   see [Configuration chapter](2_config.html) for more details)
 - `sdks/*/db-dump` scripts to get the initial list of available and installed SDKs.
 
 Please refer to `sdks/README.md` for more information about scripts definition
diff --git a/docs/part-2/2_xds-agent/0_abstract.md b/docs/part-2/2_xds-agent/0_abstract.md
index d73bdb9..b867d89 100644
--- a/docs/part-2/2_xds-agent/0_abstract.md
+++ b/docs/part-2/2_xds-agent/0_abstract.md
@@ -13,7 +13,7 @@ used to remotely cross build applications.
 
 Links to subchapters :
 
-- [Configuration](./1_config.html)
-- [Start-up](./2_start.html)
-- [Build from scratch](./3_build.html)
+- [Build from scratch](./1_build.html)
+- [Configuration](./2_config.html)
+- [Start-up](./3_start.html)
 - [Debugging](./4_debug.html)
diff --git a/docs/part-2/2_xds-agent/3_build.md b/docs/part-2/2_xds-agent/1_build.md
index 842f582..842f582 100644
--- a/docs/part-2/2_xds-agent/3_build.md
+++ b/docs/part-2/2_xds-agent/1_build.md
diff --git a/docs/part-2/2_xds-agent/1_config.md b/docs/part-2/2_xds-agent/2_config.md
index 9e912cb..9e912cb 100644
--- a/docs/part-2/2_xds-agent/1_config.md
+++ b/docs/part-2/2_xds-agent/2_config.md
diff --git a/docs/part-2/2_xds-agent/2_start.md b/docs/part-2/2_xds-agent/3_start.md
index c537c93..d750fac 100644
--- a/docs/part-2/2_xds-agent/2_start.md
+++ b/docs/part-2/2_xds-agent/3_start.md
@@ -23,7 +23,7 @@ systemctl --user stop xds-agent
 
 Default settings are defined in  `/etc/default/xds-agent` file but these
 settings you can overwritten by `$HOME/.xds/agent/agent-config.json` file,
-see [Configuration chapter](./1_config.html) for more details.
+see [Configuration chapter](./2_config.html) for more details.
 
 ## Manual start-up
 
diff --git a/docs/part-2/3_xds-cli/0_abstract.md b/docs/part-2/3_xds-cli/0_abstract.md
index df7db6c..ef86c49 100644
--- a/docs/part-2/3_xds-cli/0_abstract.md
+++ b/docs/part-2/3_xds-cli/0_abstract.md
@@ -9,7 +9,7 @@ line.
 
 Links to subchapters :
 
-- [Configuration](./1_config.html)
-- [Start-up](./2_commands.html)
-- [Build from scratch](./3_build.html)
+- [Build from scratch](./1_build.html)
+- [Configuration](./2_config.html)
+- [Start-up](./3_commands.html)
 - [Debugging](./4_debug.html)
diff --git a/docs/part-2/3_xds-cli/3_build.md b/docs/part-2/3_xds-cli/1_build.md
index b42b00c..b42b00c 100644
--- a/docs/part-2/3_xds-cli/3_build.md
+++ b/docs/part-2/3_xds-cli/1_build.md
diff --git a/docs/part-2/3_xds-cli/1_config.md b/docs/part-2/3_xds-cli/2_config.md
index 82506ee..82506ee 100644
--- a/docs/part-2/3_xds-cli/1_config.md
+++ b/docs/part-2/3_xds-cli/2_config.md
diff --git a/docs/part-2/3_xds-cli/2_commands.md b/docs/part-2/3_xds-cli/3_commands.md
index 599906c..599906c 100644
--- a/docs/part-2/3_xds-cli/2_commands.md
+++ b/docs/part-2/3_xds-cli/3_commands.md
diff --git a/docs/part-2/4_xds-gdb/0_abstract.md b/docs/part-2/4_xds-gdb/0_abstract.md
index d282efa..e5f0c25 100644
--- a/docs/part-2/4_xds-gdb/0_abstract.md
+++ b/docs/part-2/4_xds-gdb/0_abstract.md
@@ -19,6 +19,6 @@ variable to use native gdb debug mode instead.
 
 Links to subchapters :
 
-- [Configuration](./1_config.html)
-- [Build from scratch](./2_build.html)
+- [Build from scratch](./1_build.html)
+- [Configuration](./2_config.html)
 - [Debugging](./3_debug.html)
diff --git a/docs/part-2/4_xds-gdb/2_build.md b/docs/part-2/4_xds-gdb/1_build.md
index 9ec91b3..9ec91b3 100644
--- a/docs/part-2/4_xds-gdb/2_build.md
+++ b/docs/part-2/4_xds-gdb/1_build.md
diff --git a/docs/part-2/4_xds-gdb/1_config.md b/docs/part-2/4_xds-gdb/2_config.md
index 8568f18..8568f18 100644
--- a/docs/part-2/4_xds-gdb/1_config.md
+++ b/docs/part-2/4_xds-gdb/2_config.md