adds documentation to markup