improved documentation & enforce data type array on parse() & analyze()