У меня небольшой опыть code review, но мы делали его так:
когда ревьюишь - пишишь коммент в коде:
```js
// @chestozo: может обернём в какой-нибудь no.json? no.json.parse()?
return JSON.parse(paramString);
```
человек когда правит дописывает свой коммент
```js
// @chestozo: может обернём в какой-нибудь no.json? no.json.parse()?
// @unknown: мы считаем, что JSON объект есть и можно не оборачивать
return JSON.parse(paramString);
```
ты когда повторно ревьюишь -- удаляешь оба коммента
```js
return JSON.parse(paramString);
```
или дописываешь новый
```js
// @chestozo: может обернём в какой-нибудь no.json? no.json.parse()?
// @unknown: мы считаем, что JSON объект есть и можно не оборачивать
// @chestozo: а как же IE?
return JSON.parse(paramString);
```

И так, пока не приходим к конценсусу.

Комменты к коду на гитхабе не видны в коде и потому их можно просто потерять
А вот коммент в коде всегда можно поискать и найти неисправленные места.