Update readme with better doc formatting and examples