remove misleading comment in readme
add project status description
first crack at some auto-generated documentation