Document redirect with custom status code

README.md

@@ -498,6 +498,22 @@ action = Create.new
 action.call({ article: { title: 'Hello' }}) # => [302, {'Location' => '/articles/23'}, '']
 ```
 
+You can also redirect with a custom status code:
+
+```ruby
+class Create
+  include Lotus::Action
+
+  def call(params)
+    # ...
+    redirect_to 'http://example.com/articles/23', status: 301
+  end
+end
+
+action = Create.new
+action.call({ article: { title: 'Hello' }}) # => [301, {'Location' => '/articles/23'}, '']
+```
+
 ### Mime types
 
 Lotus::Action automatically sets the `Content-Type` header, according to the request.

lib/lotus/action/redirect.rb

@@ -19,7 +19,7 @@ module Redirect
       #
       # @since 0.1.0
       #
-      # @example
+      # @example With default status code (302)
       #   require 'lotus/controller'
       #
       #   class Create
@@ -30,6 +30,24 @@ module Redirect
       #       redirect_to 'http://example.com/articles/23'
       #     end
       #   end
+      #
+      #   action = Create.new
+      #   action.call({}) # => [302, {'Location' => '/articles/23'}, '']
+      #
+      # @example With custom status code
+      #   require 'lotus/controller'
+      #
+      #   class Create
+      #     include Lotus::Action
+      #
+      #     def call(params)
+      #       # ...
+      #       redirect_to 'http://example.com/articles/23', status: 301
+      #     end
+      #   end
+      #
+      #   action = Create.new
+      #   action.call({}) # => [301, {'Location' => '/articles/23'}, '']
       def redirect_to(url, status: 302)
         headers.merge!(LOCATION => url)
         self.status = status