adding docs to patterns