improved documentation for data portal