Review and possibly upstream `sdoc`'s RDoc patches

[st0012]

sdoc being one of the major users of rdoc has patches to workaround issues/enhance features, which @jonathanhefner compiled in this comment. We should review them and adopt the ones that make sense for rdoc users in general.