added documentation for cardinality attribute

Refactoring some mis-alignments in documentation.