As a member of the documentation private beta I was there long enough to understand well (or at least I thought so) the concepts of documentation.
There have been a lot of discussions / debates on how the content should be classified. In some cases there is not a clear solution but in others there is. (see also How to downvote, close or flag proposal documentation tags)
What it bugs me is the antlr and antlr4 tags, as I previously said
Documentation already has a feature that can handle versions internally.
I am an antlr
user and I know that there are a lot and significant differences between v3 and v4. However this does not justify to have different documentation tags for every version antlr
makes. Of course someone can say that, antlr
covers a more general concept than antlr4
. If we continue to move in the same direction we will have to create documentation tags for antlr3 and antlr2.
So why we are keeping both tags or better why in the first place we 'allowed' this to tags to be created in the documentation?
Having those in mind, a week ago I tried to move content from the antlr4
documentation to antlr
, however as you can see my 'change' was rejected. One of the comments I received is
Are you trying to move this from [antrl4] to [antlr]? If so, that's incorrect, as examples illustrate features specific to v4.
And I am here to ask, isn't this purpose of versions in the documentation?
Going one step further, would it be reasonable to create tag aliases and point every antlr*
tag to antlr
?
Additional resources