update docs for custom pages

+ added `page_action`
+ general rewrite of file
Merge pull request #1851 from Daxter/update-pages-docs

update docs for Custom Pages