I don't like if the user is getting pointed around. as long as we don't have a generic way for documentation, I vote for a full documentation in the README.