boards: espressif: update documentation

Re-work the Espressif supported boards documentation:

* Include repeated parts into included block
* Flatten the headers hierarchy
* Update the board variants usage.
* Fix references

Signed-off-by: Marek Matej <marek.matej@espressif.com>