[release-notes/gnome-3-20] developers page - small fixes

From: Allan Day <allanday src gnome org>
To: commits-list gnome org
Cc:
Subject: [release-notes/gnome-3-20] developers page - small fixes
Date: Mon, 14 Mar 2016 21:31:25 +0000 (UTC)
commit 2e6d17646d88e9d8bbe8c6b28253a33431264428
Author: Allan Day <allanpday gmail com>
Date:   Mon Mar 14 21:31:12 2016 +0000

    developers page - small fixes

 help/C/developers.page |  111 ++++++++++++++++++++++++-----------------------
 1 files changed, 57 insertions(+), 54 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index c63e258..cc44296 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -36,16 +36,16 @@
     <p>The Builder 3.20 release contains some significant new features, as well
     as a lot of polish and refinement. The options for building applications
     have been significantly extended: it is now possible to use Builder to
-    create XDG app bundles, and it is also possible to build within a JHBuild
+    create xdg-app bundles, and it is also possible to build within a JHBuild
     environment. All of these build options (and more) can be found in a new
     build configuration view (see <link
     href="https://blogs.gnome.org/chergert/2016/02/16/build-configurations-and-xdg-app/";>
     Christian Hergert's blog post</link> for more details).</p>
-    <p>A new multi-process plugin framework is another major feature for 3.20.
-    This allows plugins to add a huge range of functionality to Builder,
+    <p>A new multi-process plugin framework is another major new feature for
+    3.20. This allows plugins to add a huge range of functionality to Builder,
     including additional autocompletion providers, tools, services, build
-    systems, auto indenters, perspectives, project miners, search providers,
-    symbol resolvers, version control systems, project templates, and more.
+    systems, auto indenters, project miners, search providers, symbol
+    resolvers, version control systems, and much more.
     <link href="https://blogs.gnome.org/chergert/2016/02/27/what-can-you-extend-in-builder/";>
     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
@@ -81,30 +81,30 @@
     <title>xdg-app</title>
     <media type="image" src="figures/placeholder.png"/>
     <p><link href="https://wiki.gnome.org/Projects/SandboxedApps";>xdg-app
-    </link> is the new GNOME framework for cross-distro, sandboxed
-    applications. It aims to make it possible to create applications that can
-    be used on different distributions. It also aims to increase security, by
-    exposing as little of the host as possible to the application. 3.20 is a
-    significant moment for this initiative, with a number of core features
-    being released for the first time.</p>
-    <p>The 3.20 release of xdg-app includes tools for building and running
-    bundled applications. A new build tool called xdg-app-builder makes it
-    easy to build apps. Alexander Larsson, xdg-app's lead developer, has
-    written a five part tutorial on building apps
+    </link> is the new GNOME framework for building and distributing
+    applications. 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>
+    <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
     (<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>,
     <link href="https://blogs.gnome.org/alexl/2016/02/23/building-an-xdg-app-part-4/";>part four</link>,
     <link href="https://blogs.gnome.org/alexl/2016/02/26/building-an-xdg-app-part-5/";>part five</link>).</p>
-    <p>If you want to try installing and running an xdg-app, a
+    <p>For those who want to try installing and running xdg-apps, a
     collection of nightly GNOME applications is available to try. In addition
-    to being a great way to try xdg-app, this is also test GNOME applications
-    in development, and demonstrates xdg-app's ability to install multiple
-    different versions of the same application at the same time. For more
-    information,
+    to being a great way to try xdg-app, this is also a great way to test
+    development versions of GNOME applications, and demonstrates xdg-app's
+    ability to install multiple different versions of the same application at
+    the same time. For more information,
     <link href="https://blogs.gnome.org/alexl/2016/02/11/testing-unstable-gnome-using-xdg-app/";>
     a tutorial is available</link>.</p>
-    <p>Other significant developments in the 3.20 cycle include:</p>
+    <p>Other significant changes in the 3.20 release include:</p>
     <list>
       <item><p>It is now possible to create and distribute single file
       application bundles. This is particularly useful for distributing
@@ -113,14 +113,15 @@
       record information about what applications are allowed to do what. This
       is one of the first steps towards application sandboxing.</p></item>
       <item><p>Detailed information about the application, such as a
-      description and screenshots, can now be included in an xdg-app bundle,
-      using the cross-desktop AppData/AppStream standard. This can be used by
-      app stores like GNOME Software to provide a rich graphical installation
-      experience.</p></item>
+      description and screenshots, can now be included in xdg-app bundles,
+      using the cross-desktop <link
+      href="https://people.freedesktop.org/~hughsient/appdata/";>AppData</link>
+      standard. This can be used by app stores, like GNOME Software, to provide
+      a rich graphical installation experience.</p></item>
       <item><p>The GNOME runtimes, which provide the common platform on which
       applications can depend, have been updated and improved, and are now
       easier to contribute to. They now include an unstable runtime, which can
-      be used to install nightly applications, or for application development.
+      be used to install nightly applications or for application development.
       For details about all the runtimes that are availalbe, see the
       <link href="https://wiki.gnome.org/Projects/SandboxedApps/Runtimes";>
       runtimes wiki page</link>.</p></item>
@@ -134,10 +135,10 @@
     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 now be specified in themes. This not only
-    increases familiarity for those already know CSS, but also much more
-    predictable, and gives theme authors more control over layout and
-    spacing.</p>
+    minimum width/height can be specified in themes. This not only increases
+    familiarity for those already know CSS, but 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>
       <item><p>CSS theming is now fully documented, and widget documentation now
     describes CSS element names and style classes.</p></item>
@@ -153,31 +154,32 @@
       CSS equivalents. However, the CSS API being introduced in 3.20 will
       remain stable.</p></item>
     </list>
-    <p>Other changes in GTK+ 3.20 include:</p>
+    <p>CSS theming isn't the only area to be enhanced in GTK+ 3.20:</p>
     <list>
-      <item><p><code>GtkShortcutsWindow</code> - a new widget to present a
-      handy overview of keyboard shortcuts and multitouch gestures in your
-      application. Describe features here.</p></item>
+      <item><p><code>GtkShortcutsWindow</code> is a new widget to present an
+      overview of keyboard shortcuts and multitouch gestures in your
+      application. Groups and pages allow shortcuts to be organized, and a
+      search feature comes built in.</p></item>
       <item><p><code>gtk-query-settings</code> is a new commandline utility to
-      query GTK+ settings that your application would see.</p></item>
+      query GTK+ settings that are visible to your application.</p></item>
       <item><p><code>gtk-builder-tool</code> has a new preview command for
       viewing .ui files.</p></item>
      <item><p>3.20 sees the first release of <link
       href="https://wiki.gnome.org/Projects/gspell";>gspell</link>, a new
       spell-checking library for GTK+ applications. It is the best library of
       its type for GTK+, and makes it easy to add spell checking to
-      <code>GtkTextView</code>. gspell already being used in gedit for 3.20.</p>
-      </item>
+      <code>GtkTextView</code>. gspell is already being used in gedit for 3.20.
+      </p></item>
       <item><p><code>gtk3-demo</code> now has a <gui>foreign drawing</gui> demo
-      that shows how to style non-GTK+ widgets with a GTK+ CSS visual theme.</p>
+      that shows how to style non-GTK+ widgets with a GTK+ visual theme.</p>
       </item>
       <item><p><code>GtkWindow</code> sizing behavior has been improved to work
       with client-side decorations. This means that <code>
       gtk_window_set_default_size()</code> must now be combined with
       <code>gtk_window_get_size()</code>: see the <link
       href="https://wiki.gnome.org/HowDoI/SaveWindowState";>save window state
-      </link> for information on best-practices for saving window size.</p>
-      </item>
+      tutorial </link> for information on best-practices for saving window size.
+      </p></item>
     </list>
   </section>
 
@@ -187,7 +189,7 @@
     <p>GTK+'s live inspector has had a number of updates for 3.20:</p>
     <list>
       <item><p>The user interface has been polished: the sidebar has been
-      replaced by a drop down in order to devote more space content display,
+      replaced by a drop down in order to devote more space to content display,
       and lists and trees have been cleaned up.</p></item>
       <item><p>Device information is now shown in the general tab.</p></item>
       <item><p>In line with GTK+'s new CSS features, CSS nodes and associated
@@ -214,13 +216,14 @@
   <section id="pygobject">
     <title>PyGObject</title>
     <p>PyGObject improvements for 3.20 include extended <code>GError</code>
-    support and performance improvements for function calls and closures.
-    Python <link href="https://lazka.github.io/pgi-docs/";>API reference</link>
-    has also been improved for 3.20:</p>
+    support and performance improvements for function calls and closures. The
+    <link href="https://lazka.github.io/pgi-docs/";>PyGObject API reference
+    </link> has also been improved for 3.20:</p>
     <list>
-      <item><p>Links have been added to git.gnome.org C source code.</p></item>
-      <item><p>Lots of improvements to the overrides documentation (including
-      <code>Gtk.ListStore</code> and <code>Gtk.TreeModelRow</code>).</p></item>
+      <item><p>Links to git.gnome.org C source code have been added.</p></item>
+      <item><p>Lots of improvements have been made to the overrides
+      documentation (including <code>Gtk.ListStore</code> and
+      <code>Gtk.TreeModelRow</code>).</p></item>
       <item><p>Search has been improved and new search settings added.</p>
       </item>
     </list>
@@ -241,17 +244,17 @@
       GtkBuilder</link> can now be used from
       <link href="https://wiki.gnome.org/Projects/Gjs";>Gjs</link>.</p></item>
       <item><p><link href="https://wiki.gnome.org/Projects/Tracker";>Tracker
-      </link> has much improved SPARQL 1.1 syntax (see the <link
+      </link> has much improved SPARQL 1.1 support (see the <link
       href="http://www.w3.org/TR/sparql11-query/";>query language</link> and
       <link href="http://www.w3.org/TR/sparql11-update/";>update language</link>
-      specifications) support. <code>DELETE {...}</code>,
-      <code>INSERT {...}</code> and <code>WHERE {...}</code> syntax is now
-      supported, <code>BIND</code> can also be used, and many SPARQL 1.1
-      builtin functions have been added.</p></item>
+      specifications). <code>DELETE {...}</code>, <code>INSERT {...}</code> and
+      <code>WHERE {...}</code> syntax is now supported, <code>BIND</code> can
+      also be used, and many SPARQL 1.1 builtin functions have been added.</p>
+        </item>
       <item><p>gitg, GNOME's graphical Git client, got a restyled repositories
       list. Commit previews and diffs have also been improved, with new styling
-      and integration with system themes (so they integrate with the standard
-      dark theme).</p></item>
+      and integration with system themes (so they are properly styled with the
+      dark system theme, for example).</p></item>
     </list>
   </section>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]