Hygiene: Improve FlowActions docs and remove dead code

* Add/clarify a couple documentation comments
* Remove button-method, which is dead

Change-Id: Ifee32554f905c25fc6813bc059765736e0d1391e