doc: describe some known issues
doc: update README.md