[SPARK-11399] Include_example should support labels to cut out different parts in one example code

• Type: Sub-task
• Status: Closed
• Priority: Major
• Resolution: Won't Fix
• Component/s: Documentation
• Assignee: Unassigned
• Reporter: Xusen Yin
• Created: 29/Oct/15 06:21
• Updated: 29/Jun/16 19:29
• Resolved: 25/Apr/16 18:33

Description

There are many small examples that do not need to create a single example file. Take the MLlib datatype page – mllib-data-types.md – as an example, code examples like creating vectors and matrices are trivial works. We can merge them into one single vector/matrix creation example. Then we use labels to distinguish each other, such as

{% include_example xxxx.scala vector_creation %}

.

The "label way" is also useful in the dialog-style code example: http://spark.apache.org/docs/latest/mllib-linear-methods.html#streaming-linear-regression.

Issue Links

• Dependent: SPARK-11381 Replace example code in mllib-linear-methods.md using include_example
• relates to: SPARK-16294 Labelling support for the include_example Jekyll plugin
• links to: [Github] Pull Request #9430 (yinxusen)