add a comment on whether or not variable shadowing is allowed
e.g. this example
```
Boolean b;
if (true) {
    Tuple<Boolean, Integer> b;
}
```