remove a few comments clarified in the design documentation