readme cleanup code sample
readme: descriptions for rest of api
readme: cleanup code samples
readme: document fieldreference