[
https://issues.apache.org/jira/browse/SPARK-10383?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15101433#comment-15101433
]
Xusen Yin commented on SPARK-10383:
-----------------------------------
I understand it now. [~mengxr] Do you want to ship the example codes to Scala
Doc and Java Doc? There is one question, example code in Python Doc comes from
Python doc test, so it is inconsistent with Python example in our
spark/examples.
> Sync example code between API doc and user guide
> ------------------------------------------------
>
> Key: SPARK-10383
> URL: https://issues.apache.org/jira/browse/SPARK-10383
> Project: Spark
> Issue Type: Brainstorming
> Components: Documentation, ML, MLlib
> Reporter: Xiangrui Meng
> Assignee: Xiangrui Meng
>
> It would be nice to provide example code in both user guide and API docs.
> However, it would become hard to keep the content in-sync. This JIRA is to
> collect approaches/processes to make it feasible.
> This is related to SPARK-10382, where we discuss how to move example code
> from user guide markdown to `spark/examples/`. After that, we can look for
> solutions that can pick up example code from `spark/examples` and make them
> available in the API doc. Though I don't know any feasible solution right
> now, those are some relevant projects:
> * https://github.com/tkawachi/sbt-doctest
> * http://www.doctester.org/
> It would be nice to hear more ideas.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
