i don't want to link to the docs since they aren't public (and i don't know if/when they will be), but it does sound weird to keep telling people to read the docs. i added a pithy terse explanation sentence and removed the "again, read the docs" bit.