re-org/document examples; make them easier to grok