empty string fix, started rewriting docs