minor: consistency and notes on issues