Awesome Reviewers expert instructions

domains / / rails/rails

Write complete API examples

Always provide complete, context-rich code examples in API documentation. Examples should show the full usage context and avoid abbreviated or partial code snippets that may confuse developers.

raw .md Documentation Ruby

Always provide complete, context-rich code examples in API documentation. Examples should show the full usage context and avoid abbreviated or partial code snippets that may confuse developers.

Key guidelines:

  • Show the complete context (e.g., wrapping code in create_table blocks)
  • Avoid interactive prompts (like irb>)
  • Use proper formatting tags for code containing spaces ()
  • Include realistic variable names and values

Example:

# ❌ Unclear context
t.bigint :account_id

# ✅ Complete context
create_table :subscriptions do |t|
  t.bigint :account_id
  t.bigint :event_ids, array: true, default: []
end