[Meta] Site changes for Dart 2

[chalin]

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 new back 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).

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

[mit-mit]

@chalin can I suggest we move the items related to updating the icon to a separate bug?

[kwalrath]

@JekCharlsonYu is in charge of what's in this [meta] issue. (It all shows up as @chalin because he opened the original issue.)

[JekCharlsonYu]

@mit-mit We were just trying to make sure that we have a place that shows up all related changes that we have with regard to the website - be it content or the actual website/logo changes. We are using this meta issue to track all the changes for dart2 properties.

I think this is better to see a more comprehensive lists and at any rate, each item has their own related issues anyway.

[chalin]

(Closed by mistake)

[kwalrath]

I'm closing this issue, since the only remaining work to do is covered by #656, #929, and #512 (plus the SO icon, which I'll deal with separately).