-
Notifications
You must be signed in to change notification settings - Fork 753
Closed
Milestone
Description
We're using the 2-beta2 milestone to track the most urgent Dart 2 issues, but here's a summary of the pages on the site and what might need to change. (Less urgent changes are under the 2-beta3 milestone.)
Note: The 2-dev version of the website is staged at https://dartlang-org-dev.firebaseapp.com. The current (1.x) version of the website will live on (and is hand-staged) at https://v1-dartlang-org.firebaseapp.com.
- Homepage - Update homepage for Dart 2 #653, Add new/const back to homepage example #693 @anders-sandholm with support from @kwalrath (PR: Updating front page with Dart 2 core tenets #665, Add
newback to the homepage example #750) - Language
- Overview - @kwalrath (minor)
- Tour - Update language tour for Dart 2 changes #507 @kwalrath (2-beta2 changes done; more to come for beta3)
- Effective Dart and subpages - Update Effective Dart to Dart 2 #632 @munificent (for now, @kwalrath has added a "Not Dart 2 compatible yet" banner: Add banner to Effective Dart #688)
- Sample Code - Update Sample Code page #655 @kwalrath (dropped the cookbook in Update samples page, remove cookbook #687, should maybe change samples, but that could wait for beta3)
- "Strong Mode Dart" pages all need updates to change "strong mode" back to "sound Dart" (see this diff), reflect the latest tool status, fix known issues - @kwalrath (PR: No more "strong mode" #694)
https://www.dartlang.org/guides/language/sound-dart
https://www.dartlang.org/guides/language/sound-faq
https://www.dartlang.org/guides/language/sound-problems - https://www.dartlang.org/guides/language/analysis-options - Update analysis-options for Dart 2 #689 @kwalrath (get rid of "Specifying strong mode", 1.x, ...) (PR: No more "strong mode" #694)
- https://www.dartlang.org/guides/language/spec - OK as is?
- Libraries
- Overview - OK as is.
- Commonly Used Dart Libraries - Review Commonly Used Dart Libraries #656 (needs review, especially of 3rd party package list)
- Create Library Packages - OK as is.
- Tour - Update library tour for Dart 2 changes #506 (is tested, but maybe additional changes will be needed)
- Dart VM - Decision: Keep it as is. Update or banner, if appropriate.
- https://www.dartlang.org/dart-vm/dart-by-example - Delete this, but leave the repo (https://github.com/dart-lang/dart-samples; Update Sample Code page #655)
- https://www.dartlang.org/dart-vm/io-library-tour - OK as is.
- https://www.dartlang.org/dart-vm/tools - OK as is.
- https://www.dartlang.org/dart-vm/tools/dart-vm - Update /dart-vm/tools/dart-vm for Dart 2 #690
- Resources - Improve (or drop) Resources page, and link to it from the sidenav #929
- Install and subpages - Move/copy webdev installation instructions to site-webdev #657 (can keep as is, for now, but soon we want separate SDK vs. web install flows, even if that means duplicated content) (PR: Refactor Install page before moving a copy to webdev #727) @chalin
- Codelabs - OK as is, but the actual codelabs (which are all on other sites) should be updated.
- Tutorials - Review all tutorials for Dart 2 #664 (review all tutorials; review index page just before milestone)
- Articles - Update or remove obsolete articles #663 (no need to update now, but consider removing some; put a warning banner on the rest) (PR Remove most occurrences of "dartium" #699)
- Dart Tips - Remove Dart Tips videos #670 (remove all)
- Tools - Review index page just before milestone.
- Static Analyzer - OK as is.
- SDK - OK as is.
- DartPad - Update DartPad screenshots #659 (will need new screenshots)
- Tools FAQ - needs review (low priority?)
- JetBrains Plugin - Remove Dartium from JetBrains instructions #660 (update to remove Dartium; PR Remove most occurrences of "dartium" #699)
- Pub - Update pub pages that reference build/server and/or transformers #649 (update/remove pages that refer to build/serve, barback, and transformers) (PRs: Remove pub build/serve & transformers #703, [1.x] Pub transformer warning #706)
- Community and Support - OK as is.
- Misc other pages that are OK as is:
- Get Started, Platforms, Testing, What Not to Commit, Code of Conduct, Who Uses Dart, Sitemap, Search, Terms.
- Author pages for Bob, Florian, and Gilad, which I've confirmed are still visited.
- Misc other pages:
- Dart 2 Updates - Recast this as a migration guide. Related: 'Dart 2 Updates' page issue - how to install
dev? #549, Change /dart-2 to be a migration guide #662. - Performance - Review Performance page #661 (remove it) (PR: Remove /performance #707)
- Guides index - Review just before milestone.
- FAQ - Update FAQ and make it more visible #366 @anders-sandholm (very out of date, but not prominently linked to)
- Publications about Dart - Let readers know that all books cover Dart 1.x #807 updates the page to say that all pubs cover Dart 1.x. We'll need a little infrastructure change to add a Dart 2 section (Update /resources/books to have info about Dart 2 books #806).
- Synonyms - Remove synonyms #260. Plan is to remove this, but we'd be happy for someone else to take this over.
- Futures and Error Handling - not tested, should probably be part of asynchrony doc consolidation (see Consider consolidation of pages covering asynchrony/generator support #512).
- Dart 2 Updates - Recast this as a migration guide. Related: 'Dart 2 Updates' page issue - how to install
Examples:
- Adjust tests for full Dart 2 runtime semantics; enable --preview-dart-2 for example tests Adjust tests for full Dart 2 runtime semantics; upgrade to SDK 2-dev.60 and enable --preview-dart-2 for example tests #908
Non-content changes:
- Switch www.dartlang.org from Dart 1.x to Dart 2. Switch to Dart 2 site; link to Dart 1.x site #654 @chalin
- Update Dart icon, website color scheme, and design. Update Dart icon, website color scheme, and design #651 @filiph @chalin (PR: Refreshed look with new logos #830). Followups:
- Drop favicon.ico in favor of a single icon.png Drop favicon.ico in favor of a single icon.png #834
- Update dartpad images once it is updated with the new Dart logo favicon Update dartpad images once it is updated with the new Dart logo favicon #833
- Footer: use primary brand blue background with monochrome logo Footer: use brand-primary blue background with monochrome logo #848
Use web logo for web platform rather than Angular shield Use web logo for web platform rather than Angular shield #849
Changes on other sites:
- Update Dart icon, website color scheme on Pub - @isoos, Update icon pub-dev#1249
- Update Dart icon in Jetbrains plugin - @devoncarew, Update Dart icon in JetBrains plugin sdk#33017
- Update Dart icon in VS Code plugin - @DanTup, Update Dart icon Dart-Code/Dart-Code#863
- Update Dart icon, website color scheme on webdev - @kwalrath with @chalin
- Replace logo etc. on https://github.com/dart-lang/logos - https://github.com/dart-lang/logos/pull/4 @chalin
- Update Dart icon on dartlang twitter account - ??
- Update DartPad favicon Update favicon to use new Dart logo dart-pad#811 has been committed; not sure when the site will be updated.
- Update dartpad images once it is updated with the new Dart logo favicon Update dartpad images once it is updated with the new Dart logo favicon #833
- Update api.dartlang.org favicon (favicon needs to get updated dartdoc#1689) - New Dart favicon dartdoc#1690 @chalin
- Update Dart icon on reddit (https://www.reddit.com/r/dartlang/) - @kwalrath sent email to moderators; https://www.reddit.com/user/knome made the change.
- Update Dart icon on SO (https://stackoverflow.com/tags/dart/info) - @kwalrath sent email to DevRel.
- Update Dart icon on gitter (https://gitter.im/dart-lang/home) - @kwalrath
- Update codelabs (linked from https://www.dartlang.org/codelabs) - @kwalrath
chenzhekl and anders-sandholm