Github user zero323 commented on the issue: https://github.com/apache/spark/pull/18051 I think there are two different problems here: - Quality of the internal R documentation. I think that fixing this is non-goal. It is not only a normal state of R packages, but also impossible to fix without hacks or serious trade-offs. - Quality of the online documentation. This is subjective but I think there is a lot to do there including, but not limited to: - Removing this IFrame nonsense. It doesn't serve any real purpose and is completely useless. - Cleaning duplicate links. Since almost everything here is S4 we duplicate the size of the index with each addition make it only harder to use. It also affects _ee also_ sections. - Trying to clean _see also_. Something like this (example SQL function): ![image](https://cloud.githubusercontent.com/assets/1554276/26349341/b8dbceba-3faf-11e7-8a1f-4c51dd7fa818.png) is just useless. - Adding some kind of search functionality. - Running all examples as a part of the internal docs build process. Having readable, highlighted examples, with actual output, would be awesome.
--- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. --- --------------------------------------------------------------------- To unsubscribe, e-mail: reviews-unsubscr...@spark.apache.org For additional commands, e-mail: reviews-h...@spark.apache.org