Look again at roles - are there builtin sphinx roles that would be more appropriate?

[bckohan]

Also consider generating role even when :make-sections: is not given.