doc: update board porting guide to match new hardware model

Update board porting guide to the design changes in the new hw model.

New section added:
- board.yml file description

Updated sections:
- Board on SoCs example table updated to new format and extra examples
  added.
- Board directory description and its files
- Writing devicetree file section updated to match new lookup patterns
- Writing Kconfig file section updated to match new lookup patterns
- Board revision handling updated

In getting started guide a note has been added with short description
of the new board and board identifier scheme.

Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>

doc/develop/getting_started/index.rst

@@ -560,6 +560,16 @@ users. Users may also use the ``-p auto`` option, which will use
 heuristics to determine if a pristine build is required, such as when building
 another sample.
 
+.. note::
+
+   A board may contain multiple SoCs or be a multicore SoC.
+   When building for such boards it is neccesary to specify the SoC or cpucore
+   for which the sample must be built.
+   For example to build :zephyr:code-sample:`blinky` for the ``cpuapp``core on
+   the :ref:`nRF5340DK <nrf5340dk_nrf5340>` the board must be provided as:
+   ``nrf5340dk/nrf5340/cpuapp``. Also read :ref:`board_and_identifiers` for more
+   details.
+
 Flash the Sample
 ****************