maropu commented on issue #28170: [SPARK-31369][SQL][DOCS] Documentation for JSON Functions URL: https://github.com/apache/spark/pull/28170#issuecomment-611899117 I asked the same question in https://github.com/apache/spark/pull/28099#discussion_r402102476. (I'm still wondering if these document pages are really necessary though) Probably, the categorized document pages only for popular built-in function groups (e.g., aggregate, array, and date/time functions) might be more useful for users than a full flatten list of the functions in `api/sql/`. For example the PostgreSQL documents have the categorized pages for the builtin functions: - aggregate functions: https://www.postgresql.org/docs/current/functions-aggregate.html - date/timestamp functions: https://www.postgresql.org/docs/current/functions-datetime.html - JSON functions: https://www.postgresql.org/docs/current/functions-json.html Probably, I think this is an issue of maintainance cost vs document quality. cc: @huaxingao @kevinyu98 @gatorsmile
---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
