From ed40010daaf0a112ae04c26e428ea24ee0c25564 Mon Sep 17 00:00:00 2001
From: Konstantin Obenland <obenland@git.wordpress.org>
Date: Thu, 25 May 2017 15:10:03 +0000
Subject: [PATCH] About: Further polish for feature descriptions.

Also adds Under The Hood content.

Props apmarshall, azaozz, iandunn, bridgetwillard, melchoyce.
See #40721.



git-svn-id: https://develop.svn.wordpress.org/trunk@40838 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-admin/about.php | 146 ++++++++++++++---------------------------
 1 file changed, 50 insertions(+), 96 deletions(-)

diff --git a/src/wp-admin/about.php b/src/wp-admin/about.php
index 08409d9e66..b939ebf957 100644
--- a/src/wp-admin/about.php
+++ b/src/wp-admin/about.php
@@ -34,7 +34,7 @@ include( ABSPATH . 'wp-admin/admin-header.php' );
 	<div class="wrap about-wrap">
 		<h1><?php printf( __( 'Welcome to WordPress&nbsp;%s' ), $display_version ); ?></h1>
 
-		<p class="about-text"><?php printf( __( 'Thank you for updating to the latest version! WordPress %s is a user-focused release with updates that will give you peace of mind.' ), $display_version ); ?></p>
+		<p class="about-text"><?php printf( __( 'Thank you for updating to the latest version! WordPress %s helps you add more content to your widgets (like media!) faster and easier.' ), $display_version ); ?></p>
 		<div class="wp-badge"><?php printf( __( 'Version %s' ), $display_version ); ?></div>
 
 		<h2 class="nav-tab-wrapper wp-clearfix">
@@ -43,22 +43,40 @@ include( ABSPATH . 'wp-admin/admin-header.php' );
 			<a href="freedoms.php" class="nav-tab"><?php _e( 'Freedoms' ); ?></a>
 		</h2>
 
-		<div class="headline-feature feature-video">
-			<iframe width="1050" height="591" src="<?php echo esc_url( $video_url ); ?>" frameborder="0" allowfullscreen></iframe>
-			<script src="https://videopress.com/videopress-iframe.js"></script>
+		<div class="feature-section one-col">
+			<h2><?php _e( 'An Update with You in Mind' ); ?></h2>
+			<p class="lead-description"><?php _e( 'WordPress 4.8 adds some great new features &mdash; gear up for a more intuitive WordPress!' ); ?></p>
+			<p><?php _e( 'Though some updates are tiny (TinyMCE, that is &mdash; see what we did there?) they&#8217;ve been developed by hundreds of Core Contributors and Committers with <em>you</em> in mind.' ); ?></p>
+			<p><?php _e( 'Get ready for new features you&#8217;ll welcome like an old friend: link improvements, <em>three</em> new media widgets covering images, audio, and video, an updated text widget that supports visual editing, and an upgraded news section in your dashboard which brings in nearby and upcoming WordPress events.' ); ?></p>
 		</div>
 
 		<hr />
 
-		<div class="feature-section one-col">
-			<h2><?php _e( 'An Update with End Users in Mind!' ); ?></h2>
-			<p class="lead-description"><?php _e( 'WordPress 4.8 adds new some great new features: gear up for a more intuitive WordPress! Though some updates are tiny (TinyMCE, that is &mdash; see what we did there?) they&#8217;ve been developed with you in mind by hundreds of Core Contributors and Committers.' ); ?></p>
-			<p><?php _e( 'Get ready for new features you&#8217;ll welcome like an old friend: link improvements, three new media widgets, an updated text widget, and an upgraded news section in your dashboard. Navigate with purpose, intuitively in and out of text links. Embrace several new media widgets covering images, audio, and video, and an enhancement to the text widget which supports visual editing.' ); ?></p>
-			<blockquote>
-				<p><?php _e( '&#8220;The last time a new widget was introduced, Vuvuzelas were a thing, Angry Birds started taking over phones, and WordPress stopped shipping with Kubrick. Seven years and 17 releases without new widgets were enough. Time to spice up your sidebar!&#8221;' ); ?></p>
-				<p><cite><?php _e( 'The WordPress Team' ); ?></cite></p>
-			</blockquote>
-			<p><?php _e( 'A revamp of the dashboard news widget brings in nearby and upcoming events including Meetups and WordCamps. Never miss a WordPress Meetup or Camp near you again! ' ); ?></p>
+		<h2><?php _e( 'Exciting Widget Updates' ); ?></h2>
+		<div class="feature-section two-col">
+			<div class="col">
+				<div style="height:254px;width:480px;background:black;"></div>
+				<h3><?php _e( 'Image Widget' ); ?></h3>
+				<p><?php _e( 'Adding an image to a widget is now a simple task that is achievable for any WordPress user without hiring a developer. (Don&#8217;t tell them we told you that.) Simply insert your image right within the widget settings &mdash; try adding a headshot and brief bio &mdash; and see it appear, automatically.' );?></p>
+			</div>
+			<div class="col">
+				<div style="height:254px;width:480px;background:black;"></div>
+				<h3><?php _e( 'Video Widget' ); ?></h3>
+				<p><?php _e( 'A welcome video is a great way to humanize the branding of your website. It creates trust and empathy in your visitors. You can now add any video from your Media Library to a sidebar on your site with the new Video Widget. So, you, too, can be liked and trusted instantly.' ); ?></p>
+			</div>
+		</div>
+
+		<div class="feature-section two-col">
+			<div class="col">
+				<div style="height:254px;width:480px;background:black;"></div>
+				<h3><?php _e( 'Audio Widget' ); ?></h3>
+				<p><?php _e( 'Are you a podcaster or musician? Adding a widget with your audio file has never been easier. Upload your audio file to the media library, go to the widget settings, select your file, and you&#8217;re done. This would be a great way to add a more intimate welcome message, too!' );?></p>
+			</div>
+			<div class="col">
+				<div style="height:254px;width:480px;background:black;"></div>
+				<h3><?php _e( 'Rich Text Widget' ); ?></h3>
+				<p><?php _e( 'This feature deserves a ticker-tape parade down Main Street. Rich-text editing capabilities are now native for text widgets. Simply, add a widget anywhere and format away. Create lists, add emphasis with bold or italics, and easily insert links. Have fun with your new-found formatting powers, but try to use them for good!' ); ?></p>
+			</div>
 		</div>
 
 		<hr />
@@ -66,7 +84,7 @@ include( ABSPATH . 'wp-admin/admin-header.php' );
 		<div class="feature-section two-col">
 			<div class="col">
 				<h3><?php _e( 'Link Boundaries' ); ?></h3>
-				<p><?php _e( 'Have you ever tried updating a link or the text around a link, but you can&#8217;t seem to edit it correctly? You try to add a word after the link, and your new text also ends up linked. You try to add more words to a link but they end up outside the link. Frustrating! It was an annoying, confusing experience. This new feature streamlines that process. You&#8217;ll be happier. We promise.' ); ?></p>
+				<p><?php _e( 'Have you ever tried updating a link or the text around a link, but you can&#8217;t seem to edit it correctly? You try to add a word after the link and your new text also ends up linked. You try to add more words to a link but they end up outside the link. Frustrating! This new feature streamlines that process. You&#8217;ll be happier. We promise.' ); ?></p>
 			</div>
 			<div class="col">
 				<?php
@@ -81,60 +99,16 @@ include( ABSPATH . 'wp-admin/admin-header.php' );
 			</div>
 		</div>
 
-		<div class="feature-section two-col">
-			<div class="col">
-				<h3><?php _e( 'Image Widget' ); ?></h3>
-				<?php
-				echo wp_video_shortcode( array(
-					'mp4'      => 'https://s.w.org/images/core/4.7/edit-shortcuts-v1.mp4',
-					'poster'   => 'https://s.w.org/images/core/4.7/edit-shortcuts.jpg?v2',
-					'width'    => 2520,
-					'height'   => 1454,
-					// 'class'    => 'wp-video-shortcode feature-video',
-				) );
-				?>
-				<p><?php _e( 'Adding an image to a widget used to be a multistep process requiring visits to multiple screens. Now, adding an image is achievable for any WordPress user without hiring a developer. (Don&#8217;t tell them we told you that.) Simply insert your image right within the widget settings &mdash; try adding a headshot and brief bio &mdash; and see it appear&hellip; automatically.' );?></p>
-			</div>
-			<div class="col">
-				<h3><?php _e( 'Video Widget' ); ?></h3>
-				<?php
-				echo wp_video_shortcode( array(
-					'mp4'      => 'https://s.w.org/images/core/4.7/header-video-v1.mp4',
-					'poster'   => 'https://s.w.org/images/core/4.7/header-video.jpg?v2',
-					'width'    => 2520,
-					'height'   => 1454,
-					// 'class'    => 'wp-video-shortcode feature-video',
-				) );
-				?>
-				<p><?php _e( 'A welcome video in a sidebar widget is a great way to humanize the branding of your website. People follow blogs from people they know and like and buy from brands they trust. Add a video to your media library and include it in your sidebar lickety-split; and you, too, can be liked and trusted instantly.' ); ?></p>
-			</div>
-		</div>
+		<hr />
 
 		<div class="feature-section two-col">
-			<div class="col">
-				<h3><?php _e( 'Audio Widget' ); ?></h3>
-				<img src="https://s.w.org/images/core/4.7/nav-menus-760.jpg?v2" srcset="https://s.w.org/images/core/4.7/nav-menus-760.jpg?v2 760w, https://s.w.org/images/core/4.7/nav-menus-280.jpg?v2 280w, https://s.w.org/images/core/4.7/nav-menus-536.jpg?v2 536w, https://s.w.org/images/core/4.7/nav-menus-745.jpg?v2 745w" sizes="(max-width: 500px) calc(100vw - 40px), (max-width: 781px) calc((100vw - 70px) * .466), (max-width: 959px) calc((100vw - 116px) * .469), (max-width: 1290px) calc((100vw - 240px) * .472), 496px" alt="" />
-				<p><?php _e( 'Are you a podcaster or musician? Adding a widget with your audio file has never been easier. Upload your audio file to the media library, go to the widget settings, select your file, and you&#8217;re done. This would be a great way to add a more intimate welcome message, too!' );?></p>
-			</div>
-			<div class="col">
-				<h3><?php _e( 'Rich Text Widget' ); ?></h3>
-				<img src="https://s.w.org/images/core/4.7/css-760.jpg?v2" srcset="https://s.w.org/images/core/4.7/css-760.jpg?v2 760w, https://s.w.org/images/core/4.7/css-280.jpg?v2 280w, https://s.w.org/images/core/4.7/css-547.jpg?v2 547w" sizes="(max-width: 500px) calc(100vw - 40px), (max-width: 781px) calc((100vw - 70px) * .466), (max-width: 959px) calc((100vw - 116px) * .469), (max-width: 1290px) calc((100vw - 240px) * .472), 496px" alt="" />
-				<p><?php _e( 'This feature deserves a ticker-tape parade down Main Street &mdash; no more Googling to remember how to bold text! This user-friendly feature adds rich-text editing capabilities to text widgets, just like the Visual Editor that we&#8217;re all familiar with. Add a widget anywhere, and format away. Create lists, add emphasis with bold or italics, and easily insert links, no HTML necessary. Have fun with your new-found formatting powers &mdash; try to use them for good!' ); ?></p>
-			</div>
-		</div>
-
-		<div class="feature-section one-col">
+			<div class="col" style="height:254px;width:480px;background:black;"></div>
 			<div class="col">
 				<h3><?php _e( 'Nearby WordPress Events' ); ?></h3>
-				<p><?php _e( 'This is one of our favorite features. While you are in your dashboard (because you&#8217;re running updates and writing posts, right?) you can see all upcoming WordCamps and WordPress Meetups &mdash; localized to you.' ); ?></p>
-				<p><?php
-					printf(
-						/* translators: 1: Link to meetup.com, 2: Link to central.wordcamp.org */
-						__( 'Not everyone has the time to go to %1$s or %2$s to find the next WordCamp. Many randomly discover WordPress events on Twitter. WordPress now brings you the events you need to continue improving your WordPress skills, meet friends, and, of course, publish!' ),
-						'<a href="https://meetup.com/pro/wordpress">meetup.com/pro/wordpress</a>',
-						'<a href="https://central.wordcamp.org/schedule">central.wordcamp.org/schedule</a>'
-					);
-				?></p>
+
+				<p><?php _e( 'Did you know that WordPress has a thriving offline community with groups meeting regularly in more than 400 cities around the world?' ); ?></p>
+
+				<p><?php _e( 'Being part of the community can help you improve your WordPress skills and network with people you wouldn&#8217;t otherwise meet. Now you can easily find your local events just by logging in to your dashboard.' ); ?>
 			</div>
 		</div>
 
@@ -151,53 +125,33 @@ include( ABSPATH . 'wp-admin/admin-header.php' );
 
 			<div class="under-the-hood three-col">
 				<div class="col">
-					<h3><a href="https://make.wordpress.org/core/2016/11/03/post-type-templates-in-4-7/"><?php _e( 'Post Type Templates' ); ?></a></h3>
-					<p><?php _e( 'By opening up the page template functionality to all post types, theme developers have even more flexibility with the WordPress template hierarchy.' ); ?></p>
+					<h3><a href="https://make.wordpress.org/core/2017/05/17/cleaner-headings-in-the-admin-screens/"><?php _e( 'More Accessible Admin Panel Headings' ); ?></a></h3>
+					<p><?php _e( 'New CSS rules mean extraneous content (like &ldquo;Add New&rdquo; links) no longer need to be included in admin-area headings. This improves accessibility for those using assistive technologies.' ); ?></p>
 				</div>
 				<div class="col">
-					<h3><?php _e( 'More Theme API Goodies' ); ?></h3>
-					<p><?php
-						printf(
-							/* translators: %s: https://make.wordpress.org/core/2016/09/09/new-functions-hooks-and-behaviour-for-theme-developers-in-wordpress-4-7/  */
-							__( 'WordPress 4.7 includes <a href="%s">new functions, hooks, and behavior</a> for theme developers.' ),
-							'https://make.wordpress.org/core/2016/09/09/new-functions-hooks-and-behaviour-for-theme-developers-in-wordpress-4-7/'
-						);
-					?></p>
+					<h3><a href="https://make.wordpress.org/core/2017/05/22/removal-of-core-embedding-support-for-wmv-and-wma-file-formats/"><?php _e( 'Removal of Core Support for WMV and WMA Files' ); ?></a></h3>
+					<p><?php _e( 'As fewer and fewer browsers support Silverlight, file formats which require the presence of the Silverlight plugin are being removed from core support. Files will still display as a download link, but will no longer be embedded automatically.' ); ?></p>
 				</div>
 				<div class="col">
-					<h3><a href="https://make.wordpress.org/core/2016/10/04/custom-bulk-actions/"><?php _e( 'Custom Bulk Actions' ); ?></a></h3>
-					<p><?php _e( 'List tables, now with more than bulk edit and delete.' ); ?></p>
+					<h3><a href="https://make.wordpress.org/core/2017/05/22/multisite-focused-changes-in-4-8/"><?php _e( 'Multisite Updates' ); ?></a></h3>
+					<p><?php _e( 'New capabilities checks have been added to 4.8 with an eye towards removing calls to <code>is_super_admin()</code>. Additionally, new hooks, network-specific site functions, and user count controls have been added.' ); ?></p>
 				</div>
 			</div>
 
 			<div class="under-the-hood three-col">
 				<div class="col">
-					<h3><a href="https://make.wordpress.org/core/2016/09/08/wp_hook-next-generation-actions-and-filters/"><code>WP_Hook</code></a></h3>
-					<p><?php
-						printf(
-							/* translators: %s: https://make.wordpress.org/core/2016/09/08/wp_hook-next-generation-actions-and-filters/  */
-							__( 'The code that lies beneath actions and filters has been overhauled and modernized, fixing bugs along the way.' ),
-							'https://make.wordpress.org/core/2016/09/08/wp_hook-next-generation-actions-and-filters/'
-						);
-					?></p>
+					<h3><a href="https://make.wordpress.org/core/2017/05/23/addition-of-tinymce-to-the-text-widget/"><?php _e( 'Text-Editor JavaScript API' ); ?></a></h3>
+					<p><?php _e( 'With the addition of TinyMCE to the text widget in 4.8 comes a new JavaScript API for instantiating the editor after page load. This can be used to add an editor instance to any textarea and customize it with buttons and functions.' ); ?></p>
 				</div>
 				<div class="col">
-					<h3><?php _e( 'Settings Registration API' ); ?></h3>
-					<p><?php
-						printf(
-							/* translators: 1: register_setting(), 2: https://make.wordpress.org/core/2016/10/26/registering-your-settings-in-wordpress-4-7/ */
-							__( '%1$s <a href="%2$s">has been enhanced</a> to include type, description, and REST API visibility.' ),
-							'<code>register_setting()</code>',
-							'https://make.wordpress.org/core/2016/10/26/registering-your-settings-in-wordpress-4-7/'
-						);
-					?></p>
+					<h3><?php _e( 'Media Widgets for Images, Audio, and Video' ); ?></h3>
+					<p><?php _e( 'A new base media widget was added in 4.8. It is used by the three new media widgets. These widgets utilize the REST API to interact with the media library and pave the way for more media widgets to come.' ); ?></p>
 				</div>
 				<div class="col">
-					<h3><a href="https://make.wordpress.org/core/2016/10/12/customize-changesets-technical-design-decisions/"><?php _e( 'Customize Changesets' ); ?></a></h3>
-					<p><?php _e( 'Customize changesets make changes in the customizer persistent, like autosave drafts. They also make exciting new features like starter content possible.' ); ?></p>
+					<h3><a href="https://make.wordpress.org/core/2017/05/16/customizer-sidebar-width-is-now-variable/"><?php _e( 'Customizer Width Variable' ); ?></a></h3>
+					<p><?php _e( 'New responsive breakpoints have been added to the customizer sidebar to make it wider on high-resolution screens. Customizer controls should use percentage-based widths instead of pixels.' ); ?></p>
 				</div>
 			</div>
-
 		</div>
 
 		<hr />