docs, requires and whitespace