ruby-on-rails - 如何使用 YARD 记录 Rails 的 url_helpers 的使用？

Question

当尝试为使用 Rails 实现的服务生成 YARD 文档时，我收到以下警告：

$ yardoc
[warn]: in YARD::Handlers::Ruby::MixinHandler: Undocumentable mixin: 
          YARD::Parser::UndocumentableError for class MyClass
[warn]:     in file 'app/models/my_class.rb':7:
  7: include Rails.application.routes.url_helpers

我的理解是 YARD 无法确定 mixin 的类型，因为它仅在运行时可用。

那么在这里做什么是正确的呢？是否可以正确记录mixin？如果没有，我该如何摆脱警告？

Answer 1

Yard Undocumentable Error docs该描述可能会回答您的问题。据我所知，要消除警告，可以yardoc选择以安静模式运行：

yardoc -q /path/to/source/file