make documentation format yard compatible, fix typo and remove unwanted documentation.