update docs for custom pages

+ added `page_action`
+ general rewrite of file