[
https://issues.apache.org/jira/browse/SPARK-24530?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16524510#comment-16524510
]
Xiangrui Meng commented on SPARK-24530:
---------------------------------------
Confirmed that macOS, python 3, and Sphinx v1.6.6 can produce correct doc on my
machine. I didn't find any reports on Sphinx github. So if we could make a
minimal reproducible example, we should report the issue to Sphinx. On our
side, we should update the release procedure doc to use Python 3 to generate
docs. We should also update the official docs that are broken (2.1.2, 2.2.1,
2.3.1).
[~hyukjin.kwon] Do you have time to take this ticket? (feel free to say no if
you are busy:)
cc: [~smilegator]
> pyspark.ml doesn't generate class docs correctly
> ------------------------------------------------
>
> Key: SPARK-24530
> URL: https://issues.apache.org/jira/browse/SPARK-24530
> Project: Spark
> Issue Type: Bug
> Components: ML, PySpark
> Affects Versions: 2.4.0
> Reporter: Xiangrui Meng
> Priority: Blocker
> Attachments: Screen Shot 2018-06-12 at 8.23.18 AM.png, Screen Shot
> 2018-06-12 at 8.23.29 AM.png, image-2018-06-13-15-15-51-025.png,
> pyspark-ml-doc-utuntu18.04-python2.7-sphinx-1.7.5.png
>
>
> I generated python docs from master locally using `make html`. However, the
> generated html doc doesn't render class docs correctly. I attached the
> screenshot from Spark 2.3 docs and master docs generated on my local. Not
> sure if this is because my local setup.
> cc: [~dongjoon] Could you help verify?
>
> The followings are our released doc status. Some recent docs seems to be
> broken.
> *2.1.x*
> (O)
> [https://spark.apache.org/docs/2.1.0/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
> (O)
> [https://spark.apache.org/docs/2.1.1/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
> (X)
> [https://spark.apache.org/docs/2.1.2/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
> *2.2.x*
> (O)
> [https://spark.apache.org/docs/2.2.0/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
> (X)
> [https://spark.apache.org/docs/2.2.1/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
> *2.3.x*
> (O)
> [https://spark.apache.org/docs/2.3.0/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
> (X)
> [https://spark.apache.org/docs/2.3.1/api/python/pyspark.ml.html#pyspark.ml.classification.LogisticRegression]
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org
For additional commands, e-mail: issues-h...@spark.apache.org
