improve documentation on editing & adding docs