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 的类型，因为它仅在运行时可用。

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

Answer 1

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

yardoc -q /path/to/source/file