docs: Add directory structure

Add directory structure to the README.
Update the description of folders in the directory
structure table to make it more informative.

Signed-off-by: Anna Matczak <anna.matczak@arm.com>