fix code in doc
make names attribute warning a TODO
update README