doc: hardware: add documentation for clock management subsystem

Add documentation for clock management subsystem. This documentation
includes descriptions of the clock management consumer API, as well as
implementation guidelines for clock drivers themselves

Signed-off-by: Daniel DeGrasse <daniel.degrasse@nxp.com>

Author: danieldegrasse