[release-notes/gnome-3-26] developers page - final corrections



commit f4638e9da902af4e1251a92ba5d0926007e1b914
Author: Allan Day <allanpday gmail com>
Date:   Wed Sep 6 19:03:56 2017 +0100

    developers page - final corrections

 help/C/developers.page |   40 ++++++++++++++++++----------------------
 1 files changed, 18 insertions(+), 22 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 13edbb0..f760919 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -28,38 +28,36 @@
   <section id="builder">
     <title>Builder</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p><app>Builder</app>, the GNOME integrated development environment (IDE)
+    <p><app>Builder</app>, the GNOME integrated development environment (IDE),
     has made major advances in 3.26, with general improvements as well as new
     features. One of the most obvious changes in the new version is a redesigned
     editor interface. This makes it easier to open and switch between files,
     terminals and documentation, using either the header popover or the project
     sidebar. There have been a lot of user interface refinements as part of
     this work, including document headers which blend into the background.</p>
-    <p>With 3.26 it's now possible to search for symbols throughout your entire
+    <p>With 3.26 it's now possible to search for symbols throughout your
     project. Selecting a search result jumps to that location, so you can
-    quickly move around your project using only the keyboard. The
-    presentation of search results has also been improved.</p>
+    quickly navigate using only the keyboard. The presentation of search
+    results has also been improved.</p>
     <media type="image" src="figures/placeholder.png"/>
     <p>Builder includes a debugging feature for the first time in 3.26. This is
     an initial preview and is expected to mature in subsequent releases.
-    The debugger allows running your project in debug mode and stepping through
-    to find the source of issues. This includes debugging Flatpak applications.</p>
+    The debugger allows running your project in debug mode and to step through
+    to find the source of issues. It supports debugging Flatpak applications.</p>
     <media type="image" src="figures/placeholder.png"/>
     <p>Contextual documentation popovers are another new feature for this
     release. To quickly look up documentation for the code that you're working
     on, just hover the pointer over the function that you're interested in or
     place the text cursor within the function and press
     <key>F2</key> (or <keyseq><key>Shift</key><key>K</key></keyseq> in Vim mode).</p>
-    <p>There are many other improvements in Builder 3.26, including:</p>
+    <p>There are many other improvements in Builder 3.26. These are just some of them:</p>
     <list>
       <item><p>You can now jump from a symbol to where it's defined. To do this, open a context menu for the 
symbol and select <gui>Go to Definition</gui>. Alternatively, place the text cursor within the symbol and 
press <keyseq><key>Alt</key><key>.</key></keyseq> (in Vim mode the equivalent is <key>g</key> 
<key>d</key>).</p></item>
       <item><p>Word completion now provides better suggestions. This can be activated using 
<keyseq><key>Crtl</key><key>N</key></keyseq> (or <keyseq><key>Crtl</key><key>P</key></keyseq> when in Vim 
mode).</p></item>
       <item><p>SDKs are no longer automatically downloaded on metered connections, in order to save 
bandwidth.</p></item>
       <item><p>The Todo plugin has been rewritten to be faster and use less memory.</p></item>
-      <item><p>It is now possible to live preview Syphinx documentation as you edit it. To use this feature, 
select <gui>Open Preview</gui> from the document header.</p></item>
-      <item><p>Keyboard shortcut handling is now more predictable, thanks to a new keyboard shortcut engine. 
This is expected to deliver more improvements in the future.</p></item>
-      <item><p>There has been a lot of attention to detail for 3.26, particularly around the use of 
animations, to create a smoother and more cohesive experience.</p></item>
-      <item><p>Builder's project templates allow you to quickly start a new project. These now use Meson and 
allow specifying JavaScript as the language, so that they follow modern GNOME development 
practices.</p></item>
+      <item><p>It's now possible to live preview Sphinx documentation as you edit it. To use this feature, 
select <gui>Open Preview</gui> from the document header.</p></item>
+      <item><p>Builder's project templates now use Meson and allow specifying JavaScript as the language, so 
that they follow modern GNOME development practices.</p></item>
       <item><p>Background operations are now displayed in the project popover and can be paused. This is 
used to communicate when source code is being indexed.</p></item>
       <item><p>More preferences have been added, such as controls for autosave behavior.</p></item>
     </list>
@@ -69,7 +67,6 @@
 
     Things that were suggested for inclusion but weren't fully understood or didn't seem worth mentioning:
 
-     * A symbol resolver based on the code-index allows jumping between source and declarations.
      * Clang completion provider improvements. Language Server Protocol improvements - now supports find 
references and formater.
      * Live code indentation improvements.
      * New retab plugin, build notifications, and more. Possible description of build notifications - 
"System notifications are now shown when a long-running process completes and you are not using Builder (this 
can be controlled from the <gui>Notification of progress</gui> extension."
@@ -86,7 +83,7 @@
     <media type="image" src="figures/flatpak.png"/>
     <!-- Versions since 3.24: 0.8.5, 0.9.2, 0.9.3, 0.9.4, 0.8.6, 0.9.5, 0.8.7, 0.9.6, 0.9.7, 0.9.8, 0.9.9, 
0.9.10 -->
     <p><app>Flatpak</app> is the new technology for distributing and installing
-    applications. While it is independent of the GNOME project, Flatpak is an
+    applications. While it's independent of the GNOME project, Flatpak is an
     increasingly important part of GNOME's developer experience, and is
     integrated throughout GNOME.</p>
     <p>Major improvements have been seen in Flatpak since GNOME 3.24. Most
@@ -100,18 +97,17 @@
       module.</p></item>
       <item><p>Flatpak applications can now be used through accessibility
       frameworks.</p></item>
-      <item><p>It is now possible to use input methods within Flatpak
+      <item><p>It's now possible to use input methods within Flatpak
       applications.</p></item>
       <item><p>An experimental peer to peer installation method allows using
-      dynamically available repository sources, including removable
+      dynamically available software sources, including removable
       media or resources on the local network.</p></item>
       <item><p>Flatpak now supports a default language setting, which is used
       to ensure that the correct translations are installed for each
       application.</p></item>
-      <item><p>Thera have been a number of enhancements that improve security.</p></item>
       <item><p>Improved progress reporting, particularly for download and
       installation progress.</p></item>
-      <item><p>Lots of improvements to the command line tool, including a new
+      <item><p>Lots of improvements to the command line interface, including a new
       <code>flatpak repo</code> command, better presentation of results and
       smarter handling of <code>.flatpakref</code> files.</p></item>
     </list>
@@ -120,7 +116,7 @@
     of improvements. These include:</p>
     <list>
       <item><p>Performance improvements which make building much faster.</p></item>
-      <item><p>It is now possible to specify both a tag and commit ID for Git
+      <item><p>It's now possible to specify both a tag and commit ID for Git
       sources.</p></item>
       <item><p>Manifests can specify SDK extensions to be installed for the
       application to build.</p></item>
@@ -136,21 +132,21 @@
   <section id="more">
     <title>Other Improvements</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p></p>
+    <p>Other improvements in GNOME 3.26 include:</p>
     <list>
       <item><p>GLib unicode support has been updated to 10.0.0.</p></item>
       <item><p>The <code>gtk3-icon-browser</code> tool can now copy the icon name to the 
clipboard.</p></item>
       <item><p>GTK+ has gained support for color emoji. New input hints
       (<code>GTK_INPUT_HINT_EMOJI</code> and <code>GTK_INPUT_HINT_NO_EMOJI</code>)
-      are available and the new emoji picker can be enabled for text entry
+      are available and a new emoji picker can be enabled for text entry
       fields with the <code>show-emoji-icon</code> property.</p></item>
       <item><p><link its:translate="no" href="https://csoriano.gitlab.io/libcloudprovidersweb/";>
       libcloudprovider</link> is a new library that allows cloud providers to
       integrate with GNOME's file browsing experience. The library can be used
       to display cloud drives in the files sidebar, which is shown in the file
       chooser dialogs and in the <app>Files</app> application. Each cloud provider
-      can display its status (whether it is syncing, and so on) and can also
-      specify a menu of options which users can access.</p></item>
+      can display its status and can also specify a menu of options which users
+      can access.</p></item>
     </list>
   </section>
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]