more docs rewriting to clarify context and custom actions