Suggestion: Avoid showing people what *not* to do

[mark-summerfield]

In http://docs.julialang.org/en/latest/manual/types.html
in the "Value Types" section it gives an example of a Val type and then at then end says "you would never want to write actual code as illustrated above". This doesn't make any sense -- why show what people shouldn't do? I suggest mentioning the concept and then linking to a more "advanced" section of the manual and in that section, show an example that actually makes sense.

[yuyichao]

Those are simple and clear examples showing how it works and the correct way to use it is described in the section linked http://docs.julialang.org/en/latest/manual/performance-tips.html#Types-with-values-as-parameters-1 .

[yuyichao]

also, these should be reported to https://github.com/JuliaLang/julia instead.