Enhancement/registry setup instructions

docs/.pages

@@ -1,10 +1,9 @@
 nav:
   - index.md
   - introduction.md
-  - get_started.md 
+  - get_started.md
   - guides
   - examples.md
   - references
-  - ... 
-  - troubleshooting_and_faq.md 
-
+  - ...
+  - Troubleshooting and FAQs: troubleshooting_and_faq

docs/get_started.md

@@ -21,13 +21,13 @@ Other operating systems may be compatible.
 The Management Packs generated by the VMware Aria Operations Integration SDK will only run on versions that support containerized Management Packs. Currently, this is limited to on-prem installs, version 8.10 or later.
 In addition, at least one Cloud Proxy (also version 8.10 or later) must be set up in VMware Aria Operations, as containerized Management Packs must be run on a Cloud Proxy collector.
 
-#### Dependencies
+#### Prerequisites
 
 * Docker 20.10.0 or later. Updating to the latest stable version is recommended. For instructions on installing Docker,
   go to [Docker's installation documentation](https://docs.docker.com/engine/install/),
   follow the instructions provided for your operating system. Finally, make sure the Docker default socket is enabled in the
   **Advanced** tab in **Settings** (version 4.18.0 and above).
-* Container registry with read and write access (see [FAQ and Troubleshooting](troubleshooting_and_faq.md#why-do-i-need-a-container-registry) for additional information).
+* Container registry with read and write access (see [Container Registries (FAQs)](./troubleshooting_and_faq/container_registries.md#why-do-i-need-a-container-registry) for additional information).
 * Python3 3.9.0 or later. Updating to the latest stable version is recommended. Python 3.8 and earlier (including Python2) are not supported. For instructions on installing Python, go
   to [Python's installation documentation](https://wiki.python.org/moin/BeginnersGuide/Download),
   and follow the instructions provided for your operating system.

docs/references/mp-build.md

@@ -10,7 +10,14 @@ any tests on the adapter; to test the adapter code, use the [test tool](mp-test.
 * The [VMware Aria Operations Integration SDK](../index.md#installation) is installed, with the virtual environment active.
 * A Management Pack project created by the [mp-init](mp-init.md) tool.
 * Write permissions to a container registry that is accessible from VMware Aria Operations.
+* Access to the Docker daemon
 
+???+ info
+
+    When the Docker daemon is not accessible, mp-init might crash with the "Cannot connect to the Docker daemon"
+    error. For more information about this error, visit the [Docker](../troubleshooting_and_faq/docker.md#when-using-mp-test-and-mp-build-i-get-a-cannot-connect-to-the-docker-daemon-error)
+    Troubleshooting and FAQs section.
+
 ## Input
 
 ### Command-line Arguments

docs/references/mp-test.md

@@ -11,6 +11,13 @@ If the test tool runs error-free on each endpoint, then the Management Pack shou
 
 * The [VMware Aria Operations Integration SDK](../index.md#installation) is installed, with the virtual environment active.
 * A Management Pack project created by the [mp-init](mp-init.md) tool.
+* Access to the Docker daemon
+
+???+ info
+
+    When the Docker daemon is not accessible, mp-init might crash with the "Cannot connect to the Docker daemon"
+    error. For more information about this error, visit the [Docker](../troubleshooting_and_faq/docker.md#when-using-mp-test-and-mp-build-i-get-a-cannot-connect-to-the-docker-daemon-error)
+    Troubleshooting and FAQs section.
 
 ## Input
 

docs/troubleshooting_and_faq/.pages

@@ -0,0 +1,3 @@
+nav:
+  - ...
+  - other.md

docs/troubleshooting_and_faq/build.md

@@ -0,0 +1,33 @@
+# mp-build
+
+
+### mp-build returns 'Unable to build pak file'
+
+In most cases, this error indicates issues with building the container image. The most probable causes are:
+
+1. Unknown Instruction :
+
+  ```
+  mp-build
+  Building adapter [Finished]
+  Unable to build pak file
+  ERROR: Unable to build Docker file at /Users/user/code/aria_ops/management-packs/test:
+   {'message': 'dockerfile parse error line 7: unknown instruction: COP'}
+
+  ```
+2. A command  inside the Dockerfile failed:
+
+  ```
+  mp-build
+  Building adapter [Finished]
+  Unable to build pak file
+  ERROR: Unable to build Docker file at /Users/user/code/management-packs/test:
+   The command '/bin/sh -c pip3 install -r adapter_requirements.txt --upgrade' returned a non-zero code: 1
+  ```
+The solution for case 1 to fix the typo/command by editing the Dockerfile. For case 2, however, the solution might not be evident at first sight. Since the error
+comes from building the image itself, we can run `docker build .` in the project's root directory and look at the stack trace for clues.
+
+???+ info
+
+    For issues regarding mp-build and docker, see [Docker's](docker.md) page.
+