Skip to main content
Post Closed as "Not suitable for this site" by pnuts, Michael Gaskill, Code Lღver, jhpratt, Stephen RauchMod
replaced http://stackoverflow.com/ with https://stackoverflow.com/
Source Link

Not long ago, a documentation topic for Java 8 featuresJava 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015ECMAScript 2015, but it only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.

Not long ago, a documentation topic for Java 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015, but it only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.

Not long ago, a documentation topic for Java 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015, but it only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.

edited body
Source Link
E_net4
  • 29.9k
  • 10
  • 66
  • 116

Not long ago, a documentation topic for Java 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015, but isit only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.

Not long ago, a documentation topic for Java 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015, but is only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.

Not long ago, a documentation topic for Java 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015, but it only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.

Source Link
E_net4
  • 29.9k
  • 10
  • 66
  • 116

Should we be making documentation topics for new features in a specific language version?

Not long ago, a documentation topic for Java 8 features was requested, and that caught my attention. Should we really be making topics that aggregate new features in a language?

I can only think of drawbacks when doing this. Such features usually deserve their own documentation topic, and they will then have a range of language versions reflecting that. One can (in theory) retrieve a list of all documentation topics that only apply from that version onward. It is also debatable whether fetching a list of new features in a language is a requirement for SO Documentation, but the means to perform this query on the user interface can be added in the future if it turns out to be something reasonable to have.

Furthermore, it appears that the JavaScript tag has one for ECMAScript 2015, but is only covers a very small part of what was introduced in the new standard. Even if it covered all changes and additions, we'd end up with redundant content because one or more features might have already been covered by their own topic.

With all this in mind, I would say that we should not make such topics (your votes should reflect this opinion for consistency), but I would gladly like to hear your thoughts.