I like having tons of docs in the README, vertical screen space is cheap.