[release-notes/gnome-3-20] developers - rework pygobject and gtk+ css text

[Allan Day <allanday src gnome org>]

commit 5a6bf309d7bbd823ba00b90f9dc864bfbe24a23f
Author: Allan Day <allanpday gmail com>
Date:   Mon Mar 14 14:21:16 2016 +0000

    developers - rework pygobject and gtk+ css text

 help/C/developers.page |   68 ++++++++++++++++++++++++++----------------------
 1 files changed, 37 insertions(+), 31 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index d8b2881..e15d4a9 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -130,35 +130,38 @@
   <section id="gtk+">
     <title>GTK+</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>It has been a big cycle for GTK+, with major changes to CSS styling:</p>
+    <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
+    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>
     <list>
-      <item><p>GTK+ now supports the CSS box model much more consistently, so
-      theme authors can use margins, padding, min-width, min-height like you
-      would on the web.</p></item>
-      <item><p>Widget documentation now describes CSS element names and style
-      classes have been documented (see the CSS nodes section of the
-      documentation for each widget, and <link
-      href="https://developer.gnome.org/gtk3/unstable/theming.html";>theming in
-      GTK+ overview</link>.</p></item>
-      <item><p>New CSS features are now supported, including <code>
-      radial-gradient()</code>, <code>rem</code> and <code>calc()</code>.</p>
-      </item>
-      <item><p>As a part of GTK+'s transition to CSS theming, many style
-      properties have been deprecated in favor of CSS equivalents.</p></item>
+      <item><p>CSS theming is now fully documented, and widget documentation now
+    describes CSS element names and style classes.</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>
+      <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>
     </list>
-    <p>These changes mean that existing custom CSS and themes will need to be
-    updated for GTK+ 3.20, but the CSS interface will be stable in the future.
-    </p>
-    <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>
-    <p>Other changes in GTK+ 3.20:</p>
+    <p>Other changes in GTK+ 3.20 include:</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>gtk-query-settings</code> is a new commandline utility to
       query GTK+ settings that your application would see.</p></item>
-      <item><p><code>gtk-builder-tool</code> has a new preview command to test
-      .ui files.</p></item>
-<!-- TODO: what kind of issues does gtk-builder-tool allow you to test for? Why is it useful? -->
+      <item><p><code>gtk-builder-tool</code> has a new preview command for
+      viewing .ui files.</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>
       </item>
@@ -198,14 +201,16 @@
 
   <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>
     <list>
-      <item><p>Improved GError support.</p></item>
-      <item><p>Performance improvements for function calls and closures.</p></item>
-      <item><p>Functions returning multiple values now return named tuples .</p></item>
-      <item><p>Python API Reference includes links to C implementations. Many
-      improvements regarding overrides documentation (<code>Gtk.ListStore
-      </code>, <code>Gtk.TreeModelRow</code>. ...). Improved search and new
-      search settings.</p></item>
+      <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>Search has been improved and new search settings added.</p>
+      </item>
     </list>
   </section>
 
@@ -223,6 +228,7 @@
       see this bug for details).</p></item>
       <item><p>Tracker - Much improved SPARQL 1.1 syntax support (Update and
       Query) (Better developer docs to be written before release).</p></item>
+<!-- gitg got a restyled repository list. check on this -->
     </list>
   </section>