Cosolidate doc block headers

Also, some examples use

    ### Example:

some

    ## Example:

Should we also consolidate the heading levels?