Sidebar descriptions provide an opportunity to provide context about where the sidebar is located or when it is loaded. We should encourage theme developers to use them, similar to how we hint default images for custom headers and backgrounds. The callback’s outdated documentation describes the function in an early state of Toolbox (introduced in r3678-wpcom-themes), the earliest public record would be https://themes.trac.wordpress.org/browser/toolbox/0.3/functions.php#L99 This is as good an opportunity to update it as any. Props @emiluzelac for initial patch. Fixes #433.
displayed by `single.php`. See http://codex.wordpress.org/Template_Hierarchy
* Update PHPDoc. * Add periods to the end of comment sentences. * Limit line length to 80 chars. * Use C++-style PHP comments only for function and file documentation.
- Reduce element comments to either the element id or the first element class. - Tabs > Spaces. - Improve adherence to formatting guidelines.
* Removes sample theme options * Adds Theme Customizer enhancement (actually working!) Goal: Emphasize the use of the Customizer versus out of style Theme Options.
This is probably left over from a time when there was a line break following the HTML tag.