development adjustments

Added more precise comments, adjusted function names, adjusted HTML
spacing and naming conventions, adding future proof semantic mark-up