Currently it's a bit awkward to link to feature specifications on the language repository. When they are being worked on, then accepted, then released, their link changes every time. Beyond that, the links are long and definitely not memorable.
Developers often love to see what's coming, learn from the specifications, track them, share them, etc. We also use these links occasionally on dart.dev.
We should consider tracking redirects that we handle updating, so we can have a persistent link to link to from anywhere, sort of similar to Flutter design docs that live at flutter.dev/go/.
This could be done on this repository, but it would probably be better on the language repository's spec.dart.dev Firebase instance, which would allow atomic updates of the redirects as the documents move. Then we could add a single redirect from dart.dev to spec.dart.dev for those design docs.
If we managed this in dart-lang/language, the workflow would look like:
When adding a design doc:
Add the redirect to dart-lang/language's firebase.json under a name /feature-spec/class-modifiers or something similar.
Add the dart.dev redirect link to the document at the top of the feature specification itself for easy sharing.
When moving it to a different directory, replace the destination URL.
Currently it's a bit awkward to link to feature specifications on the language repository. When they are being worked on, then accepted, then released, their link changes every time. Beyond that, the links are long and definitely not memorable.
Developers often love to see what's coming, learn from the specifications, track them, share them, etc. We also use these links occasionally on dart.dev.
We should consider tracking redirects that we handle updating, so we can have a persistent link to link to from anywhere, sort of similar to Flutter design docs that live at
flutter.dev/go/
.This could be done on this repository, but it would probably be better on the language repository's
spec.dart.dev
Firebase instance, which would allow atomic updates of the redirects as the documents move. Then we could add a single redirect fromdart.dev
tospec.dart.dev
for those design docs.If we managed this in
dart-lang/language
, the workflow would look like:dart-lang/language
'sfirebase.json
under a name/feature-spec/class-modifiers
or something similar.\cc @MaryaBelanger