2015-10-31 24 views
6

レールを文書化するためにヤードを使用するにはどのように私はこれに似たActiveRecordのクラスを持っている:列挙型の

class User < ActiveRecord::Base 

    # How do I document this? 
    enum status [:registering, :active, :suspended, :deleted] 
end 

status属性は、状態マシンを構築するために使用されます。ヤードを使用してその行のコードを文書化するにはどうすればよいですか?ドキュメントには、status属性の説明とすべての可能な状態が含まれている必要があります。

答えて

4
class User < ActiveRecord::Base 

    # @attr [Enumerable<Symbol>] status 
    enum status [:registering, :active, :suspended, :deleted] 
end 
1

すべてのオプションをカンマ区切りリストとして表示するだけです。あなたは型定義がわからない場合は

class User < ActiveRecord::Base 

    # @!attribute [rw] status 
    # @return [:registering, :active, :suspended, :deleted] 
    enum status [:registering, :active, :suspended, :deleted] 
end 

、あなたはYARD Type Parserに相談することがあります。より良い答えがないために、あなたに授与さ

+0

バウンティを;) –

+0

それは記号の代わりに文字列を返します。 – ypresto