added usage example and moved documentation upward