Added comments to public interface.
began to write the Readme