fix: some grammar mistakes in JavaDocs
add: usage examples