documented with explanatory comments