mod/power_distributor/doc: Add module documentation

Adding power_distributor documentation which explains the module purpose and operation.

The document is in markdown format and for the best viewing experience it should be used on viewers that provide mermaid rendering.

Signed-off-by: Mohamed Omar Asaker mohamed.omarasaker@arm.com