add more docs, remove old syntax