Merge pull request activeadmin#1851 from Daxter/update-pages-docs

update docs for Custom Pages

Author: pcreux

docs/10-custom-pages.md

@@ -1,8 +1,13 @@
 # Custom Pages
 
-Although it's nice to be able to register resources, sometimes you need a non
-resourceful page in your application. Active Admin supports the generation of
-custom pages using the same familiar syntax available for resources.
+When you need a standalone page on your site, Custom Pages will be there with a familiar syntax to resource registration.
+
+## Available Features
+* main page content
+* menu item
+* sidebars
+* action_items
+* page_actions
 
 ## Create a new Page
 
@@ -15,31 +20,17 @@ Creating a page is a simple as calling the `register_page` method:
     end
 
 In the above example, a new page will be created at `/admin/my_page` with the
-title "My Page" and the content of "Hello World". Anything rendered within the
-`#content` block will be set in the main content area of the page.
+title "My Page" and the content of "Hello World". Anything rendered within
+`content` will be the main content on the page.
 
 ## Page Title & I18n
 
 Coming soon...
 
 ## Customize the Menu
 
-The menu item is available to customize just like in any other resource in
-Active Admin:
-
-    ActiveAdmin.register_page "My Page" do
-      menu :label => "My Menu Item Label", :parent => "Dashboard"
-
-      content do
-        para "Hello World"
-      end
-    end
-
-This configuration will add the page to the menu with the label "My Menu Item
-Label" and will nest it underneath the "Dashboard" link.
-
-To view the full list of available menu options visit ([Resource
-Customization](2-resource-customization.md))
+The menu item is available to customize just like
+[any other resource](2-resource-customization.md#customize-the-menu) in Active Admin.
 
 ## Add a Sidebar Section
 
@@ -59,11 +50,8 @@ in Active Admin:
       end
     end
 
-This configuration creates a sidebar section named "Help" with an unordered list
-in it. 
-
-To view the full list of available sidebar section options visit
-([Sidebars](7-sidebars.md))
+This creates a sidebar section named "Help" containing an unordered list. 
+To view the full customization options, visit [Sidebars](7-sidebars.md).
 
 ## Add an Action Item
 
@@ -80,5 +68,29 @@ Just like other resources, you can add Action Item's to pages:
       end
     end
 
-This configuration adds an action item that links to the root URL of the
-application.
+This adds an action item that links to the root URL of the application.
+
+## Add a Page Action
+
+`page_action` allows you to define controller actions specific to this page,
+and is the functional equivalent of `collection_action`.
+
+    ActiveAdmin.register_page "My Page" do
+
+      page_action :ex, :method => :post do
+        # do stuff here
+        redirect_to admin_my_page_path, :notice => "You did stuff!"
+      end
+      
+      action_item do
+        link_to "Do Stuff", admin_my_page_ex_path, :method => :post
+      end
+      
+      content do
+        para "Hello World"
+      end
+    end
+
+This defines the route `/admin/my_page/ex` which can handle HTTP POST requests.
+
+Clicking on the `action_item` will reload page with the message "You did stuff!"