docs: Update documents to include the PSA Crypto option

Top level README.md along with applications' documents
are updated to illustrate how the new PSA Crypto APIs
implementation configuration option can be used, and
mention the available configurations for the new option.

Signed-off-by: Ahmed Ismail <Ahmed.Ismail@arm.com>