Erik Ernst
9e1bbc1203
A couple of feature specs did not explicitly say that they are now background material and normative language should be found in specific other places. This CL does that. It also makes the README.md even more explicit in order to make the same point. Change-Id: I79cbd86a662faf478ce41c01e09c5f32a3f03cd3 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/134824 Reviewed-by: Lasse R.H. Nielsen <lrn@google.com> Commit-Queue: Erik Ernst <eernst@google.com>
Background material about features
This directory contains background material only. Consult the language specification and the language repository for current information.
What is a feature specification?
In order to move faster and get better feedback, we implement and iterate on language changes before the full official specification has been written. Still, the implementers need something to go on.
For that, the language team writes feature specifications. These are intended to be precise enough for a good faith implementer to correctly understand the syntax and semantics of the language, but when the contents of a feature specification is integrated into the language specification we expect the extra processing to give rise to additional clarifications and corrections, which means that a feature specification is expected to be nearly as complete and correct as the language specification.
Feature specifications in this directory
This directory contains older feature specifications, newer ones can be found in, respectively should be submitted to, the language repository here.
The status of every feature specification in this directory is that it is background material, and the contents has been integrated into the language specification. Consequently, these feature specifications can only be used as a source of informal background information. Precise rules about the features should be looked up in the language specification.