Add some detailed docs for one of the actions so we can discuss