rearrange docs

according to docs sync meeting

Author: alzix

docs/api/security/psa_attestation.md

@@ -0,0 +1,19 @@
+## PSA Attestation
+
+### Description
+
+TODO: AlexV
+
+
+### Specification
+TODO: AlexV - describe here about APIs and the difference in behavior whether bootlaoder is present or not
+
+PSA specification can be found here [PSA Secure Storage](https://pages.arm.com/PSA-APIs)
+
+### Doxygen
+
+TODO: AlexV - find PSA attestation APIs in doxygen web site once merged - perhaps will be generated over night.
+ if it is conditionally compiled under some ifdef make sure to add it to doxyfile_options
+ Once addded Doxygen will be generate - perhaps on next day fix the link below
+
+[![View code](https://www.mbed.com/embed/?type=library)](../mbed-os-api-doxy/psa__prot__internal__storage_8h.html)

docs/api/security/psa_crypto.md

@@ -0,0 +1,20 @@
+## PSA Crypto
+
+### Description
+
+TODO: Jaeden
+
+
+### Specification
+TODO: Jaeden - describe here about APIs being available from NSPE and SPE
+about differences in behaviour if any
+
+PSA specification can be found here [PSA Secure Storage](https://pages.arm.com/PSA-APIs)
+
+### Doxygen
+
+TODO: Jaeden - find PSA crypto APIs in doxygen web site. I was not able to find it. 
+ Perhaps MBED_TLS_PSA_CRYPTO_C macro should be added doxyfile_options file so PSA crypto docs will be generated 
+ Once addded Doxygen will be generate - perhaps on next day fix the link below
+ 
+[![View code](https://www.mbed.com/embed/?type=library)](../mbed-os-api-doxy/psa__prot__internal__storage_8h.html)

docs/api/security/psa_internal_storage.md

@@ -0,0 +1,20 @@
+## PSA Internal Storage
+
+### Description
+
+PSA internal storage APIs allows saving and retrieving data from PSA internal flash.
+
+PSA internal storage is implementation varies depending on the target type:
+- on single core ARMv7-M target it PSA internal storage APIs are implemented by calling to "default" internal TDBStore instance.
+- on PSA targets implementing SPM, PSA internal storage implemented as a secure service. PSA internal storage has access control list, 
+ which makes sure that only the entries created from NSPE will be accessible to it.
+
+### Specification
+
+API specification in mbed-os specific context can be found here: [mbed-os/Storage](../../storage/storage.md) 
+
+PSA specification can be found here [PSA Secure Storage](https://pages.arm.com/PSA-APIs)
+
+### Doxygen
+
+[![View code](https://www.mbed.com/embed/?type=library)](../mbed-os-api-doxy/psa__prot__internal__storage_8h.html)

docs/api/security/psa_protected_storage.md

@@ -0,0 +1,19 @@
+## PSA Protected Storage
+
+### Description
+
+PSA Protected storage APIs allows saving and retrieving data from PSA protected storage.
+
+Unlike [PSA Internal storage](./psa_internal_storage.md), PSA Protected storage implemented to always run in NSPE side and redirect the calls to KVStore instance.
+
+TODO: Danniel Benor - review and add links to this page from Storage landing page 
+
+### Specification
+
+API specification in mbed-os specific context can be found here: [mbed-os/Storage](../../storage/storage.md) 
+
+PSA specification can be found here [PSA Secure Storage](https://pages.arm.com/PSA-APIs)
+
+### Doxygen
+
+[![View code](https://www.mbed.com/embed/?type=library)](../mbed-os-api-doxy/protected__storage_8h.html)

docs/api/security/security.md

@@ -2,10 +2,20 @@
 
 Security on Arm Mbed OS is divided into the following parts:
 
-- Platform Security Architecture (PSA). For information about working with PSA in the context of Mbed OS, please see [Mbed PSA asset protection](../apis/psa-api.html).
+- [PSA SPM](./spm.md) - used for accessing secure services within Secure Processing environment (on PSA targets only)
 
- For full details, please see the [PSA site](https://developer.arm.com/products/architecture/security-architectures/platform-security-architecture).
+- [PSA internal storage](./psa_internal_storage.md) - used to save PSA RoT state
+
+- [PSA protected storage](./psa_protected_storage.md)
+
+- [PSA Crypto](psa_crypto.md) 
 
 - Mbed TLS. For information about working with Mbed TLS in the context of Mbed OS, please see [Connection security through Arm Mbed TLS](../apis/tls.html).
 
  For full details, please see the [Mbed TLS site](https://tls.mbed.org/).
+
+- [[PSA Attestation](psa_attestation.md)
+
+- [PSA Lifecycle](./lifecycle/psa_lifecycle.md)
+
+- [Device Key](./DeviceKey.md)

docs/api/security/spm.md

@@ -0,0 +1,13 @@
+## SPM APIs
+
+### Description
+
+PSA SPM APIs are used for calling Secure Services within Secure Processing environment
+
+### Specification
+
+More details can be found in [Platform Security Architecture - Firmware Framework ](https://pages.arm.com/psa-resources-ff.html)
+
+### Doxygen
+
+[![View code](https://www.mbed.com/embed/?type=library)](../mbed-os-api-doxy/group___s_p_m.html)