improved docs, slightly