RubyDoc documentation is empty

[jornvandebeek]

It seems the RubyDoc documentation is not generated anymore, see http://rubydoc.info/github/orgsync/active_interaction

[tfausak]

That's weird. We haven't changed anything about our integration. I can generate the YARD locally without issue.

[tfausak]

I created a ticket for this.

[AaronLasseigne]

Thanks for letting us know.

[zapnap]

Looks like this is most likely because of the markup provider / markup combination in your .yardopts:

--markup-provider rdoc
--markup markdown

This might be an incompatibility with the version of rdoc we're using / pinned on rubydoc. Any reason not to use redcarpet, ghm or a more popular markdown library?

[lsegal]

rubydoc.info doesn't support rdoc markdown. You can get a list of supported providers for each markup type here: https://github.com/lsegal/yard/blob/master/lib/yard/templates/helpers/markup_helper.rb#L23-L50

[tfausak]

Wait, what? It says :rdoc right here: https://github.com/lsegal/yard/blob/11e1930720105adc3e1c6b2a4e54ea55f238b5f2/lib/yard/templates/helpers/markup_helper.rb#L31.

And check out #27 for our rationale for using RDoc.

[lsegal]

Oh, oops! I forgot that we recently changed this. My bad. Unfortunately rubydoc.info doesn't use an rdoc version that is compatible with the RDoc markdown markup (it needs 4.x+ and we use 3.9.x) because of compat issues: https://github.com/lsegal/rubydoc.info/blob/master/Gemfile#L6

[AaronLasseigne]

Maybe we need to take another look at kramdown.

[tfausak]

It looks like 2ad2a81 didn't fix it: http://www.rubydoc.info/github/orgsync/active_interaction.

[tfausak]

I created another ticket for this.