completed doc strings