Если я документирую свой код с помощью YARD и использую, например, тег @overload, и кто-то другой устанавливает мой гем, и он генерирует документацию с помощью RDoc, разве результат не будет грязным?
@overload
Есть ли хороший способ справиться с этим?
Is не поддерживает @overload, но TomDoc служит рабочим посредником.RDoc теперь поддерживает TomDoc из коробки, а у Yard есть плагин yard-tomdoc.YARD все еще лучше (IMO) для больших проектов, но для небольших библиотек или инструментов TomDoc хорошо работает и может использоваться обеими системами.