Erik Ernst
9f803a36eb
The Dart 1 specification of 'generic method syntax' had no status indicator, it is now marked as 'background material' because generic methods (in full) have been integrated into the language specification. Several other changes of a similar nature. Implication: It should now be possible for readers of these documents to trust their status indication. As we go, we will need to update them again, especially when something is integrated into the language specification. Do we want to migrate background material to another directory? Do we want to rename the directory `informal` to `feature` or somesuch? Change-Id: Ia3851bdbe7b5a46d71848c376906f95feb4db349 Reviewed-on: https://dart-review.googlesource.com/34663 Reviewed-by: Lasse R.H. Nielsen <lrn@google.com>
This directory contains "informal specifications".
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 "informal specifications". These are intended to be precise enough for a good faith implementer to correctly understand the syntax and semantics of the language, but without all of the laborious detail of the complete specification.
Once the feature has been implemented, tested, and we are confident in it, the language team will write the real text in the language specification and the document here becomes deprecated and no longer canonical.
Until then, while the feature is in progress, a live pull request for the informal spec is the source of truth for the feature.