[release-notes/gnome-3-20] developers - refine the builder section

[Allan Day <allanday src gnome org>]

commit 11ba05e3d1d853b8c9aecd0d263f4bfd53b7942e
Author: Allan Day <allanpday gmail com>
Date:   Sun Mar 13 15:17:58 2016 +0000

    developers - refine the builder section

 help/C/developers.page |   82 ++++++++++++++++++++++++++++--------------------
 1 files changed, 48 insertions(+), 34 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 91a13b7..d8b2881 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -28,40 +28,54 @@
   <section id="builder">
     <title>Builder</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Builder has gained many new features in the latest development cycle!
-The interface has received a face-lift introducing perspectives.
-Developers can use perspectives to add new workflows to Builder through it's
-new plugin interface.</p>
-    <p>Preferences have been overhauled to help you to find the tweaks you
-need faster and with less disruption. Additionally, the new Todo plugin helps
-you locate code you forgot to fix.</p>
-    <p>Using the <cmd>ide</cmd> command line program, developers can quickly
-create new projects that use best practices within the GNOME community.</p>
-    <p>Developers wanting to experiment with new Xdg-App technology
-can now use Builder to develop their application inside of an Xdg-App
-runtime. This is a technology preview of what's to come in future
-Builder releases!</p>
-    <p>Under the hood, Builder gained support for multi-process plugins
-to reduce the affects of miss-behaving plugins.</p>
-    <p>Builder's robust VIM emulation has continued to improve, allowing
-users that prefer modal-editing to feel at home.</p>
-    <p>For languages that support semantic analysis, holding control
-while clicking on variables, types, and functions will jump you to their
-source location.</p>
-    <p>Authors of translated software will be happy to find that common
-translation mistakes are now underlined in yellow so you catch the issue
-before your translators find it.</p>
-    <p>Developers looking to extend Builder can learn more by reading
-a series of recent articles about
-<link href="https://blogs.gnome.org/chergert/2016/02/27/what-can-you-extend-in-builder/";>what you can extend 
in Builder</link>,
-<link href="https://blogs.gnome.org/chergert/2016/02/16/build-configurations-and-xdg-app/";>using 
Xdg-App</link>,
-<link href="https://blogs.gnome.org/chergert/2016/02/29/how-to-setup-distcc-and-ccache-in-builder/";>ccache 
integration</link>,
-and
-<link href="https://blogs.gnome.org/chergert/2016/01/21/builder-plugins-part-i/";>step</link> by
-<link href="https://blogs.gnome.org/chergert/2016/01/22/builder-plugins-part-ii/";>step</link>
-tutorials using Python.</p>
-    <p>Many other fit and finish bugs where fixed in this release, so
-give it a try and see how you like it!</p>
+    <p><link href="https://wiki.gnome.org/Apps/Builder";>Builder</link> is the
+    new integrated development environment for GNOME. It aims to provide
+    streamlined, powerful and modern experience for building GNOME
+    applications, and already features inline completion, powerful global
+    search, flexible panels containing editors, terminal, documentation, file
+    and symbol trees, and much more.</p>
+    <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
+    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 on this</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,
+    including additional autocompletion providers, tools, services, build
+    systems, auto indenters, perspectives, project miners, search providers,
+    symbol resolvers, version control systems, project templates, and 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
+    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>
+    <p>Other enhancements to Builder in 3.20 include:</p>
+    <list>
+      <item><p>Application preferences have been overhauled to help you to find
+      the tweaks you need faster and with less disruption.</p></item>
+      <item><p>A new to do plugin shows a list of every <code>TODO</code>,
+      <code>FIXME</code> and <code>XXX</code> in your project, and allows you
+      to navigate to their locations.</p></item>
+      <item><p>VIM emulation has continued to improve, allowing users that
+      prefer modal-editing to feel at home.</p></item>
+      <item><p>Builder now detects and highlights common <code>gettext</code>
+      errors.</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>
+    </list>
   </section>
 
   <section id="xdg-app">