improve docs in docs/ directory