refs #36 | md-ify method synopsis