Some of the planning docs make no sense:
others are wrong/incomplete ... I guess
this should get some clean-up