We use sphinx for our documentation generation, see format example here: https://github.com/Flexget/Flexget/blob/master/flexget/entry.py#L278-L282