starting to put place holders in for documentation and thinking about the initialization of the lib
after a dry run with client code, tightening up interface, updating documentation and making necessary test updates