Merge pull request #3045 from jacobherrington/docs/using-active-recor…

…d-in-decorators

Extend Decorator documentation

guides/source/developers/extensions/decorators.html.md

@@ -32,6 +32,32 @@ total by $10 (or whatever your currency is).
 
 [monkey-patch]: https://en.wikipedia.org/wiki/Monkey_patch
 
+## Using class-level methods in decorators
+
+In order to access some class-level methods, you'll need to define a special
+method.
+
+```ruby
+module MyStore::ProductDecorator
+
+  # This is the place to define custom associations, delegations, scopes and
+  # other ActiveRecord stuff
+  def self.prepended(base)
+    base.has_many :comments, dependent: :destroy
+    base.scope    :sellable, -> { base.where(...).order(...) }
+    base.delegate :something, to: :something
+  end
+
+  ...
+
+  Spree::Product.prepend self
+end
+```
+
+In this example, a decorator has been used to extend the functionality of
+`Spree::Product`. The decorator includes an ActiveRecord association, scope,
+and delegation.
+
 ## Decorators and Solidus upgrades
 
 Decorators can complicate your Solidus upgrades. If you depend on decorators,