[GitHub] spark issue #13109: [SPARK-15319][SPARKR][DOCS] Fix SparkR doc layout for co...

[mengxr]

Github user mengxr commented on the issue:

    https://github.com/apache/spark/pull/13109
  
    I just checked the generated R doc and I felt that we shouldn't group many 
methods together. For example, in this PR, the `DESCRIPTION` section looks okay 
because we used `crosstab - ...` and `freqItems - ...`. But the `Arguments` 
section becomes very messy and the `Value` section is even worse. The example 
code are chained together. See attached screenshots. `summary` is another 
example here. It might be better to only group methods are closely related to 
each other and share the same arguments.
    
    ![screen shot 2016-06-20 at 11 21 48 
pm](https://cloud.githubusercontent.com/assets/829644/16219832/e5114c38-373d-11e6-9ef3-ae05243cc46d.png)



---
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