could you put /// comments on these methods please, esp. explaining what these ints should be