Unresolved rdof-ref placeholder leaks into generated markdown

[skatkov]

Summary

An internal reference placeholder/token is leaking into the final generated markdown instead of being resolved or stripped.

Reproduction

1. Run rake vendor:setup:rails.
2. Run rake vendor:docs:rails.
3. Open vendor/docs/rails/ActionView/Helpers/FormBuilder.md.
4. Inspect the first paragraph.

Example

• vendor/docs/rails/ActionView/Helpers/FormBuilder.md:5
  • Emits: rdof-ref:ActionView::Helpers::FormHelper#form_with

Actual Result

The generated markdown contains a raw rdof-ref: token.

Expected Result

Internal reference placeholders should never appear in final output.

This should instead:

• resolve to the correct markdown link, or
• render as plain text if the target cannot be resolved.

Notes

I only found one visible instance in the current vendored output, but it looks like a specific unresolved reference path or typo in the reference handling pipeline.

[skatkov]

RDoc master comparison note: still reproduces.

Tested with ruby/rdoc master at bc0baee787609f2205e8f1103f3e1d36b923184a. ActionView/Helpers/FormBuilder.md still emits rdof-ref:ActionView::Helpers::FormHelper#form_with.

This appears to originate from Rails source containing rdof-ref rather than RDoc's expected rdoc-ref spelling:

• https://github.com/rails/rails/blob/main/actionview/lib/action_view/helpers/form_helper.rb
• RDoc reference syntax: https://github.com/ruby/rdoc/blob/master/doc/markup_reference/markdown.md#cross-references

No upstream RDoc issue for rdof-ref was found during triage. This likely needs either a Rails source fix or local defensive handling for unresolved/typoed RDoc refs.