more work on return markdown docs