GNOME.org
 

[release-notes/gnome-3-20] final edits and proof reading for the developers page

commit f8127acdc915f63814dbdf3f69ef8c0e97e93575
Author: Allan Day <allanpday gmail com>
Date:   Wed Mar 16 11:08:37 2016 +0000

    final edits and proof reading for the developers page

 help/C/developers.page |   65 +++++++++++++++++++++++------------------------
 1 files changed, 32 insertions(+), 33 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 5555525..3a997f3 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -50,10 +50,9 @@
     What can you extend in Builder</link> provides a full list of what can be
     extended using the new plugin system. There is also a tutorial that
     describes how to write your own plugins
-    (<link href="https://blogs.gnome.org/chergert/2016/01/21/builder-plugins-part-i/";>
-    part one</link>,
-    <link href="https://blogs.gnome.org/chergert/2016/01/22/builder-plugins-part-ii";>
-    part two</link>).</p>
+    (<link href="https://blogs.gnome.org/chergert/2016/01/21/builder-plugins-part-i/";>part one</link>,
+    <link href="https://blogs.gnome.org/chergert/2016/01/22/builder-plugins-part-ii";>part two</link>).
+    </p>
     <p>Other enhancements to Builder in 3.20 include:</p>
     <list>
       <item><p>Application preferences have been overhauled to help you to find
@@ -68,15 +67,14 @@
       <item><p><cmd>ide</cmd>, a new command line program, allows you to
       quickly create new projects following GNOME community best practices.</p>
       </item>
-      <item><p>For languages that support semantic analysis, holding <key>Ctrl
-      </key> while clicking on variables, types, and functions will jump to
-      their source location.</p></item>
+      <item><p>For languages that support semantic analysis, holding
+      <key>Ctrl</key> while clicking on variables, types, and functions will
+      jump to their source location.</p></item>
       <item><p>Initial support for the Vala language.</p></item>
 <!-- What does "support for" mean exactly? Is that autocompletion, error detection, buildability, or 
something else? -->
-      <item><p>Autocompletion is now faster, and has fuzzy matching.</p></item>
-      <item><p>It is now possible to <link
-      href="https://blogs.gnome.org/chergert/2016/02/29/how-to-setup-distcc-and-ccache-in-builder/";>
-      use Builder with ccache</link>.</p></item>
+      <item><p>Autocompletion is now faster and has fuzzy matching.</p></item>
+      <item><p><link 
href="https://blogs.gnome.org/chergert/2016/02/29/how-to-setup-distcc-and-ccache-in-builder/";>
+      It is now possible to use Builder with ccache</link>.</p></item>
     </list>
   </section>
 
@@ -86,15 +84,15 @@
     <p><link href="https://wiki.gnome.org/Projects/SandboxedApps";>xdg-app
     </link> is the new cross-distro framework for building and distributing
     desktop applications on GNU/Linux, which is planned to have first class
-    support in GNOME.. It makes it possible to create applications that can be
-    used on different distributions. In the future it will offer a
-    comprehensive security model for applications, by limiting how much of the
-    host is exposed to applications.</p>
+    support in GNOME. Not only does xdg-app make it possible to create
+    applications that can be used on different distributions, but it also plans
+    to offer a comprehensive security model, by limiting how much of the host
+    is exposed to applications.</p>
     <p>3.20 is a significant moment for xdg-app, with a number of core features
     being offered in a mature state for the first time. Version 3.20 includes
     <code>xdg-app-builder</code>, a new tool that makes it easy to build apps.
     Alexander Larsson, xdg-app’s lead developer, has written a five part
-    tutorial on how to use it to build xdg apps
+    tutorial on how to use this to build xdg apps
     (<link href="https://blogs.gnome.org/alexl/2016/02/19/building-an-xdg-app-part-1/";>part one</link>,
     <link href="https://blogs.gnome.org/alexl/2016/02/19/building-an-xdg-app-part-2/";>part two</link>,
     <link href="https://blogs.gnome.org/alexl/2016/02/22/building-an-xdg-app-part-3/";>part three</link>,
@@ -135,12 +133,12 @@
   <section id="gtk+">
     <title>GTK+</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>3.20 has been a big cycle for GTK+. CSS theming has had a major
-    overhaul, resulting in significant improvements, with easier theme writing,
-    more exact visual styling, and more dynamic interfaces. GTK+ themes now
+    <p>3.20 is a big release for GTK+. CSS theming has had a major overhaul,
+    resulting in significant improvements, with easier theme writing, more
+    exact visual styling and more dynamic interfaces. GTK+ themes now
     follow the standard CSS box model much more consistently, and margins and
-    minimum width/height can be specified in themes. This not only increases
-    familiarity for those already know CSS, but is also much more predictable,
+    minimum height/width can be specified in themes. This not only increases
+    familiarity for those already know CSS, but is also much more predictable
     and gives theme authors more control over layout and spacing.</p>
     <p>Other features of CSS theming in 3.20:</p>
     <list>
@@ -148,17 +146,18 @@
       now describes CSS element names and style classes, along with their
       structure.</p></item>
       <item><p>The introduction of CSS selectors allows greater use of
-      specificity in themes, and more flexibility and power for theme authors.
-      </p></item>
+      specificity in themes and gives more flexibility and power to theme
+      authors.</p></item>
       <item><p>Most widgets can now be animated using CSS, allowing more
-      engaging controls, and additional CSS features are now supported,
-      including <code>radial-gradient()</code>, <code>rem</code> and
-      <code>calc()</code>.</p></item>
-      <item><p>As a result of these changes, existing GTK+ themes will need to
-      be updated, and many style properties have been deprecated in favor of
-      CSS equivalents. However, the CSS API being introduced in 3.20 will
-      remain stable.</p></item>
+      engaging and dynamic controls.</p></item>
+      <item><p>Additional CSS features are now supported, including
+      <code>radial-gradient()</code>, <code>rem</code> and <code>calc()</code>.
+      </p></item>
     </list>
+    <p>As a result of these changes, existing GTK+ themes will need to be
+    updated, and many style properties have been deprecated in favor of CSS
+    equivalents. The 3.20 CSS API will remain stable going forward, though (and
+    will continue to follow the documentation included with this version).</p>
     <p>CSS theming is not the only area to be enhanced in GTK+ 3.20:</p>
     <list>
       <item><p><code>GtkShortcutsWindow</code> is a new widget to present an
@@ -206,11 +205,11 @@
 
   <section id="webkitgtk">
     <title>WebKitGTK+</title>
-    <p>Changes in WebKitGTK+ for 3.20:</p>
+    <p>Notable changes in the 3.20 version of WebKitGTK+ include:</p>
     <list>
-      <item><p>Sessions can now be restored exactly as they were, using a <link
+      <item><p>Sessions can now be restored exactly as they were, using <link
       href="http://webkitgtk.org/reference/webkit2gtk/unstable/WebKitWebView.html";>
-      new serialize/restore API</link>.</p></item>
+      new serialize/restore APIs</link>.</p></item>
       <item><p>Scrollbars can be presented as a semi-transparent overlay, like
       standard ones in GTK+.</p></item>
       <item><p><code>onbeforeunload</code> is now supported, allowing websites
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]