Td 84 improve ds guideline (#84)

In addition to what has been done by @andygotz, .rst syntax was corrected and some markup applied.