Clean YARD documentation

Did some small changes to the YARD documentation. Sharing with you in case you would like to get them (or some of them).