SCDM-5: Documentation design decision

Issue-Ref:5