fixed comments to include better explanation and reference links