comments for IDE, variable check if declare

instance of interfaces is instanciated only once, added comments to
variables for IDE
Merge pull request #28 from matak/master

Accepting merge #28: 
1. Additional Class Documentations for IDE readability - @matak
2. Class initiation sanity checking and verification - @matak