mirror of
https://github.com/dart-lang/sdk
synced 2024-09-05 08:24:39 +00:00
Ensuring that every feature spec in SDK is marked as background material
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>
This commit is contained in:
parent
d0e779ff71
commit
9e1bbc1203
|
@ -1,24 +1,16 @@
|
||||||
### This directory contains feature specifications.
|
## Background material about features
|
||||||
|
|
||||||
**Note**: This directory contains older feature specifications, new ones
|
This directory contains background material only. Consult the
|
||||||
should be submitted to the language repository
|
[language specification](https://dart.dev/guides/language/spec)
|
||||||
[here](https://github.com/dart-lang/language).
|
and the
|
||||||
|
[language repository](https://github.com/dart-lang/language)
|
||||||
|
for current information.
|
||||||
|
|
||||||
The existing feature specifications in this directory will have their status
|
### What is a feature specification?
|
||||||
updated as we proceed, and in particular each of them will become 'background'
|
|
||||||
material as it is integrated into the language specification. When all feature
|
|
||||||
specifications in this directory (that is, all other files than this one) have
|
|
||||||
become background material, this directory will serve only as documentation for
|
|
||||||
the process whereby each feature was designed and the associated motivation.
|
|
||||||
|
|
||||||
That said, the following section contains a few words about what a feature
|
|
||||||
specification is, and how it can be used.
|
|
||||||
|
|
||||||
### What is a Feature Specification?
|
|
||||||
|
|
||||||
In order to move faster and get better feedback, we implement and iterate on
|
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,
|
language changes before the full official specification has been written.
|
||||||
the implementers need *something* to go on.
|
Still, the implementers need *something* to go on.
|
||||||
|
|
||||||
For that, the language team writes _feature specifications_. These are
|
For that, the language team writes _feature specifications_. These are
|
||||||
intended to be precise enough for a good faith implementer to correctly
|
intended to be precise enough for a good faith implementer to correctly
|
||||||
|
@ -27,3 +19,15 @@ of a feature specification is integrated into the language specification we
|
||||||
expect the extra processing to give rise to additional clarifications and
|
expect the extra processing to give rise to additional clarifications and
|
||||||
corrections, which means that a feature specification is expected to be
|
corrections, which means that a feature specification is expected to be
|
||||||
_nearly_ as complete and correct as the language specification.
|
_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](https://github.com/dart-lang/language).
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
**Owner**: eernst@
|
**Owner**: eernst@
|
||||||
|
|
||||||
**Status**: Implemented.
|
**Status**: Background material, normative language now in dartLangSpec.tex.
|
||||||
|
|
||||||
**Version**: 0.2 (2018-05-22)
|
**Version**: 0.2 (2018-05-22)
|
||||||
|
|
||||||
|
|
|
@ -4,7 +4,7 @@ Author: eernst@.
|
||||||
|
|
||||||
Version: 0.7 (2018-04-10)
|
Version: 0.7 (2018-04-10)
|
||||||
|
|
||||||
Status: Implemented.
|
Status: Background material, normative language now in dartLangSpec.tex.
|
||||||
|
|
||||||
**This document** is an informal specification of the *implicit creation*
|
**This document** is an informal specification of the *implicit creation*
|
||||||
feature. **The feature** adds support for omitting some occurrences of the
|
feature. **The feature** adds support for omitting some occurrences of the
|
||||||
|
|
|
@ -4,7 +4,7 @@
|
||||||
|
|
||||||
**Version**: 0.10 (2018-10-31)
|
**Version**: 0.10 (2018-10-31)
|
||||||
|
|
||||||
**Status**: Implemented.
|
**Status**: Background material, normative language now in dartLangSpec.tex.
|
||||||
|
|
||||||
Based on [this description](https://github.com/dart-lang/sdk/issues/27526#issuecomment-260021397) by leafp@.
|
Based on [this description](https://github.com/dart-lang/sdk/issues/27526#issuecomment-260021397) by leafp@.
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue