some much needed commenting