add usage snippet and clarify summary