tighten up wording; lower expectations
tighten up words some more
document deriving rather than leave it as magic
enable all warnings
add useful resource link