some more work on description documentation