comment fixes

@mycal-tucker @peter828 added the updated design doc. pushing this to didit. someone else might want to also take a look at the problem statement to make sure we didn't forget anything.