added low-level and high-level comments;
added configuration checks prior to beginning processing;
using github's hub tool;
removed some dead comments;