[update] cleaned up and added doc to question