documentation improvments