[update] the documentation within the code