implementation docs and kapil's code