add sitemap links, add some comments, fix/explain some magic numberes