improve docs
Fix initialization issues