rails-api · hiimtaylorjones · Aug 20, 2015 · Aug 20, 2015 · Aug 31, 2015 · Aug 31, 2015
diff --git a/docs/README.md b/docs/README.md
@@ -14,6 +14,7 @@ This is the documentation of AMS, it's focused on the **0.10.x version.**
 
 - [How to add root key](howto/add_root_key.md)
 - [How to add pagination links](howto/add_pagination_links.md)
+- [Use AMS Outside A Controller](howto/outside_controller_use.md)
 
 ## Getting Help
 

diff --git a/docs/howto/outside_controller_use.md b/docs/howto/outside_controller_use.md
@@ -0,0 +1,42 @@
+## Using AMS Outside Of A Controller
+
+### Serializing a resource 
+
+In AMS versions 0.10 or later, serializing resources outside of the controller context is fairly simple:
+
+```ruby
+# Create our resource
+post = Post.create(title: "Sample post", body: "I love Active Model Serializers!")
+
+# Optional options parameters
+options = {}
+
+# Create a serializable resource instance
+serializable_resource = ActiveModel::SerializableResource.new(post, options)
+
+# Convert your resource into json
+model_json = serializable_resource.as_json
+``` 
+
+### Retrieving a Resource's Active Model Serializer
+
+If you want to retrieve a serializer for a specific resource, you can do the following:
+
+```ruby
+# Create our resource 
+post = Post.create(title: "Another Example", body: "So much fun.")
+
+# Optional options parameters
+options = {}
+
+# Retrieve the default serializer for posts
+serializer = ActiveModel::Serializer.serializer_for(post, options)
 def serializer_instance 
   @serializer_instance ||= serializer.new(resource, serializer_opts) 
 end 
 # Get serializer either explicitly :serializer or implicitly from resource 
 # Remove :serializer key from serializer_opts 
 # Replace :serializer key with :each_serializer if present 
 def serializer 
   @serializer ||= 
     begin 
       @serializer = serializer_opts.delete(:serializer) 
       @serializer ||= ActiveModel::Serializer.serializer_for(resource) 
       if serializer_opts.key?(:each_serializer) 
         serializer_opts[:serializer] = serializer_opts.delete(:each_serializer) 
       end 
       @serializer 
     end 
 end 
 alias_method :serializer_class, :serializer 
 def serializer_instance 
   @serializer_instance ||= serializer.new(resource, serializer_opts) 
 end 
  
 # Get serializer either explicitly :serializer or implicitly from resource 
 # Remove :serializer key from serializer_opts 
 # Replace :serializer key with :each_serializer if present 
 def serializer 
   @serializer ||= 
     begin 
       @serializer = serializer_opts.delete(:serializer) 
       @serializer ||= ActiveModel::Serializer.serializer_for(resource) 
  
       if serializer_opts.key?(:each_serializer) 
         serializer_opts[:serializer] = serializer_opts.delete(:each_serializer) 
       end 
       @serializer 
     end 
 end 
 alias_method :serializer_class, :serializer 
+```
+
+You could also retrieve the serializer via: 
+
+```ruby
+ActiveModel::SerializableResource.new(post, options).serializer 
+```
+
+Both approaches will return an instance, if any, of the resource's serializer.