committed pending documentation and examples