Various docs fixes and clarifications

Fixes https://gitlab.eclipse.org/eclipse/oniro-core/meta-openharmony/-/issues/40 Fixes https://gitlab.eclipse.org/eclipse/oniro-core/meta-openharmony/-/issues/41 Fixes eclipse/oniro-core/docs#146 (closed)

recipes-openharmony/sdk/README.rst

@@ -35,8 +35,12 @@ OpenSource toolchain and third-party components with newer Oniro versions.
 Building
 ********
 
-To build `oniro-openharmony-bundle` for OpenHarmony 3.0.1, the `bitbake` command
-is simply::
+To build `oniro-openharmony-bundle` for OpenHarmony 3.0.1, an initialized build
+environment is required::
+
+    TEMPLATECONF=../meta-openharmony/conf source oe-core/oe-init-build-env
+
+Once that is in place, the `bitbake` command is simply::
 
     DISTRO=oniro-openharmony-linux MACHINE=qemuarma7 bitbake oniro-openharmony-bundle
 
@@ -62,29 +66,30 @@ Warning! It is recommended to only install OpenHarmony prebuilts to clean
 upstream OpenHarmony source repsitories, as the installation will remove files
 and entire git repositories!
 
-To install the `oniro-openharmony-bundle` to a clean OpenHarmony 3.0.1
-repository, you should do something like this::
+Firstly, you need to download an OpenHarmony archive. As an example, the next
+steps will use OpenHarmony 3.0.1. You are to download this archive from
+https://repo.huaweicloud.com/harmonyos/os/3.0.1/code-v3.0.1-LTS.tar.gz and
+dearchive it:
 
-    tar xfz $DOWNLOADS/code-v3.0.1-LTS.tar.gz
-    cd code-v3.0.1-LTS/OpenHarmony
-    $DOWNLOADS/oniro-openharmony-bundle-3.0-cortexa7-neon-vfpv4-1.99.99.sh -y -d oniro
-    ./oniro/setup.sh
+.. code-block:: console
 
-After this, you can use normal OpenHarmony build system procedures to build as
-usual.  To build image for HiSilicon Hi3516DV300 (taurus) board::
+    $ tar xfz $DOWNLOADS/code-v3.0.1-LTS.tar.gz
 
-    ./build.sh --product-name Hi3516DV300
+Note that the `$DOWNLOADS` variable needs to point to the location where the
+archive resides.
 
+To install the `oniro-openharmony-bundle` to a clean OpenHarmony 3.0.1
+repository, you should do something like this:
+
+.. code-block:: console
 
-Use inside BitBake
-******************
+    $ cd code-v3.0.1-LTS/OpenHarmony
+    $ $DOWNLOADS/oniro-openharmony-bundle-3.0-cortexa7-neon-vfpv4-1.99.99.sh -y -d oniro
+    $ ./oniro/setup.sh
+
+After this, you can use normal OpenHarmony build system procedures to build as
+usual.  To build image for HiSilicon Hi3516DV300 (taurus) board:
 
-**meta-openharmony** is a bitbake layer, containing recipes for building
-OpenHarmony software components.
+.. code-block:: console
 
-The meta-openharmony layer enables building of prebuilts for use with the
-OpenHarmony build system. A toolchain-only image, making it possible to use the
-Oniro Clang version instead of the default Clang version included, and a bundle
-image which contains both the Oniro Clang compiler and Oniro versions of various
-third-party components, replacing the corresponding default third-party
-versions.
+    $ ./build.sh --product-name Hi3516DV300