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):
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 [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
