improved docs with source example