Settings Rewrite: Update comments on related to routing.

chrome/browser/resources/settings/settings_page/settings_section.js

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**
  * @fileoverview
  * 'settings-section' shows a paper material themed section with a header
  * which shows its page title.
  *
+ * The section name must match the name specified in settings_router.js.
+ * Otherwise, settings-section will not expand and contract correctly.
+ *
  * Example:
  *
- *    <settings-section page-title="[[pageTitle]]">
+ *    <settings-section page-title="[[pageTitle]]" section="privacy">
  *      <!-- Insert your section controls here -->
  *    </settings-section>
  *
  * @group Chrome Settings Elements
  * @element settings-section
  */
 Polymer({
   is: 'settings-section',
 
   behaviors: [
     Polymer.NeonAnimationRunnerBehavior,
   ],
 
   properties: {
     /**
      * The current active route.
      */
     currentRoute: {
       type: Object,
       observer: 'currentRouteChanged_',
     },
 
     /**
      * The section is expanded to a full-page view when this property matches
      * currentRoute.section.
      */

[michaelpg, 2015/12/10 00:23:45]

likewise

[tommycli, 2015/12/10 01:59:51]

Done.

     section: {
       type: String,
     },
 
     /**
      * Title for the page header and navigation menu.
      */
     pageTitle: String,
 
     animationConfig: {
@@ skipping 128 matching lines @@
       {'top': oldRect.top + 'px', 'height': oldRect.height + 'px'},
       {'top': newRect.top + 'px', 'height': newRect.height + 'px'},
     ], this.timingFromConfig(config));
     return this._effect;
   },
 
   complete: function(config) {
     config.node.classList.remove('neon-animating');
   }
 });