Skip to content

[SPARK-16144][SPARKR] update R API doc for mllib #13993

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from

Conversation

felixcheung
Copy link
Member

What changes were proposed in this pull request?

From SPARK-16140/PR #13921 - the issue is we left write.ml doc empty:
image

Here's what I meant as the fix:
image

image

I didn't realize there was already a JIRA on this. @mengxr @yanboliang

How was this patch tested?

check doc generated.

@SparkQA
Copy link

SparkQA commented Jun 30, 2016

Test build #61533 has finished for PR 13993 at commit afc8ebe.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

#' @name predict
#' @export
#' @seealso \link{spark.glm}, \link{spark.kmeans}, \link{spark.naiveBayes}, \link{spark.survreg}
#' @seealso \link{read.ml}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not necessary to link read.ml to predict, I think here is typo.

@SparkQA
Copy link

SparkQA commented Jun 30, 2016

Test build #61557 has finished for PR 13993 at commit 1f9552e.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@yanboliang
Copy link
Contributor

The change looks good for me. For the summary issue, I left comments at JIRA.
cc @mengxr for another pass. Thanks!

@jkbradley
Copy link
Member

jkbradley commented Jul 2, 2016

CCing @junyangq too

@felixcheung
Copy link
Member Author

Any thought on this? Would be good to fix this before the next RC for 2.0.0?

@@ -53,26 +53,27 @@ setClass("AFTSurvivalRegressionModel", representation(jobj = "jobj"))
#' @note KMeansModel since 2.0.0
setClass("KMeansModel", representation(jobj = "jobj"))

#' Saves the machine learning model to the input path
#' Saves the MLlib model to the input path
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would suggest shorter title like "Save Machine Learning Model"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the convention that has been suggested is that we have the page title being the same first sentence of the description?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I sort of have some impression, but would this be too restrictive? @shivaram

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The write.ml can only be used for saving MLlib models, it can not save other machine learning model produced by native R functions. So I think the current description is accurate enough.

@junyangq
Copy link
Contributor

junyangq commented Jul 6, 2016

The other changes look good to me.

@felixcheung
Copy link
Member Author

Any thought? @shivaram what do you think?

@shivaram
Copy link
Contributor

Change LGTM. Thanks @junyangq and @yanboliang for reviewing. Merging this to master and branch-2.0

asfgit pushed a commit that referenced this pull request Jul 11, 2016
## What changes were proposed in this pull request?

From SPARK-16140/PR #13921 - the issue is we left write.ml doc empty:
![image](https://cloud.githubusercontent.com/assets/8969467/16481934/856dd0ea-3e62-11e6-9474-e4d57d1ca001.png)

Here's what I meant as the fix:
![image](https://cloud.githubusercontent.com/assets/8969467/16481943/911f02ec-3e62-11e6-9d68-17363a9f5628.png)

![image](https://cloud.githubusercontent.com/assets/8969467/16481950/9bc057aa-3e62-11e6-8127-54870701c4b1.png)

I didn't realize there was already a JIRA on this. mengxr yanboliang

## How was this patch tested?

check doc generated.

Author: Felix Cheung <felixcheung_m@hotmail.com>

Closes #13993 from felixcheung/rmllibdoc.

(cherry picked from commit 7f38b9d)
Signed-off-by: Shivaram Venkataraman <shivaram@cs.berkeley.edu>
@asfgit asfgit closed this in 7f38b9d Jul 11, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants