doc: improving doc / readability

improving doc / readability