2

MySQL's JSON data type was only added in v5.7.8, which is fairly recent (5.8 isn't yet out). Consequently, somebody has proposed adding the MySQL 5.7 version tag to the topic about it.

This version tag will obviously become outdated as soon as a newer version comes out. As such, it seems unhelpful.

Really, we need a way to indicate that some documentation applies before some version, from some version, or within a range of versions, but since we don't yet have that, how should we tag these cases?

7
  • <!-- if version [gt 5.7.8] -->JSON data type<!-- end if version -->
    – Braiam
    Commented Jul 24, 2016 at 19:33
  • @Braiam huh? Where am I supposed to type this? As the topic title? I can't find any documentation about specifying versions this way.
    – Mark Amery
    Commented Jul 24, 2016 at 19:41
  • Stuff is all over the place so it doesn't surprise me: stackoverflow.com/help/documentation-versions Allow setting version per-example, not just per-topic and I presume you know how to set them per topic.
    – Braiam
    Commented Jul 24, 2016 at 19:47
  • 2
    @Braiam aha, just found stackoverflow.com/editing-help#inline-versions which seems to be the official docs on this syntax. However, no indication on how to apply this to entire topics.
    – Mark Amery
    Commented Jul 24, 2016 at 19:51
  • There should be a topic version in the editor.
    – Braiam
    Commented Jul 24, 2016 at 20:09
  • @Braiam not for me - I just have a fixed set of versions that I can select or deselect, no free text field. Are we seeing a different UI from each other?
    – Mark Amery
    Commented Jul 24, 2016 at 20:11
  • This is a real issue. For another example: stackoverflow.com/documentation/angularjs/295/… How should this distinguish between Angular 1 and 2?
    – TrueWill
    Commented Aug 2, 2016 at 22:08

0

Browse other questions tagged .