commented code and references