GNOME.org
 

[release-notes] Polish developers.index

commit 5d99f6b482dbe842d5df90538c0c2e063fea186c
Author: Allan Day <allanpday gmail com>
Date:   Wed Sep 8 18:07:46 2021 +0100

    Polish developers.index
    
    More polish. More to be done.

 help/C/developers.page | 173 ++++++++++++++++++++++---------------------------
 1 file changed, 78 insertions(+), 95 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index ee837e58..9c878e62 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -31,8 +31,8 @@
 
   <title>What’s New for Developers</title>
 
-  <p>GNOME 41 includes some significant improvements for developers and those
-  using with the GNOME platform.</p>
+  <p>Major improvements have been made to the GNOME developer experience during
+  the GNOME 41 development cycle.</p>
 
   <section id="dev-docs">
     <title>Improved Documentation</title>
@@ -46,33 +46,41 @@
       <p>Since GNOME 40, the GNOME main developer website has been replaced,
       with
       <link href="https://developer.gnome.org/";>a new, streamlined portal</link>
-      that provides access to the main sources of documentation for GNOME
-      platform developers.</p>
+      that provides access to the main sources of documentation for those using
+      the GNOME platform.</p>
 
       <p>This is coupled with a <link
       href="https://developer.gnome.org/documentation/";>new developer docs site
       </link> that contains the most up-to-date and relevant general developer
-      documentation. This includes <link 
href="https://developer.gnome.org/documentation/guidelines.html";>guidelines</link>
-      on general programming conventions, accessibility, and localization, as 
-      well as shorter <link href="https://developer.gnome.org/documentation/tutorials.html";>tutorials</link>
-      introducing common developer tasks.</p>
-
-      <p>The new docs site also includes a new <link
-      href="https://developer.gnome.org/documentation/introduction.html";>introduction to the GNOME 
platform</link>,
-      with an overview of included components and services, information on the 
-      various programming languages that can be used, and introductions to 
-      Builder and Flatpak.</p>
+      documentation, including:</p>
+      
+      <list>
+        <item><p>A new 
+        <link href="https://developer.gnome.org/documentation/introduction.html";>introduction to the GNOME 
platform</link>,
+        which includes an overview of included components and services, 
+        information on the various programming languages that can be used, and 
+        introductions to Builder and Flatpak.</p></item>
+        <item><p><link href="https://developer.gnome.org/documentation/guidelines.html";>Guidelines</link>
+      on general topics such as programming conventions, accessibility and
+      localization.</p></item>
+        <item><p>Short
+        <link href="https://developer.gnome.org/documentation/tutorials.html";>tutorials</link>
+        on common developer tasks, like how to use notifications, or create a
+        menu in GTK.</p></item>
+      </list>
     </section>
 
     <section id="api-docs">
       <title>New API Docs</title>
 
-      <p>GTK's documentation is now generated using the new <cmd>gi-docgen</cmd>
-      tool, resulting in more accurate and consistent documentation, as well as
-      improved API docswebsites. GTK API documentation generated with this tool 
-      can be found at 
-      <link href="https://docs.gtk.org";>docs.gtk.org</link>, including 
-      documentation for
+      <p>Many GNOME libraries are now using a new API docs tool, called 
+      <cmd>gi-docgen</cmd>. This produces more accurate and consistent 
+      documentation, as well as improved documentation websites.</p>
+      
+      <p>The primary users of <cmd>gi-docgen</cmd> are GTK and its associated 
+      libraries, whose docs can be found at
+      <link href="https://docs.gtk.org";>docs.gtk.org</link>. This includes API
+      docs for:
       <link href="https://docs.gtk.org/gtk4/";>GTK</link>,
       <link href="https://docs.gtk.org/gdk4/";>GDK</link>,
       <link href="https://docs.gtk.org/gsk4/";>GSK</link>,
@@ -91,16 +99,15 @@
       has also been expanded and refined during the GNOME 41 development 
       cycle.</p>
 
-      <p>The guidelines have been updated to match contemporary design 
-      practice, so that they reflect up to date design conventions. The 
-      guidelines have also been substantially expanded, with additional 
-      material on accessibility, UI styling, adaptive UI, navigation
-      structures, and more.</p>
+      <p>The guidelines have been updated to match contemporary design
+      practice, so that they reflect up to date design conventions. They have
+      also been substantially expanded, with additional material on
+      accessibility, UI styling, adaptive UI, navigation structures, and
+      more.</p>
 
-      <p>Finally, the new HIG has been polished and is now easier to use. It 
-      has a new website, which is easy to navigate and search. Also virtually 
-      all the old content has been rewritten to make it easier to understand 
-      and use.</p>
+      <p>Finally, the HIG has a new website, which is easier to navigate and 
+      search, and virtually all the old content has been rewritten, to make the
+      guidance as accessible as possible.</p>
 
     </section>
   
@@ -112,40 +119,25 @@
     <p><app>Builder</app>, the GNOME IDE, has a large collection of enhancements
     for GNOME 41.</p>
 
-    <section id="find-in-files">
-      <title>Find in Files</title>
-      <p>Builder's "find in files" feature, which allows finding and replacing
-      strings across an entire project, has been redesigned for GNOME 41. It
-      is now located in a persistent section in the bottom panel, which makes
-      it easier to find and access, and has a new search UI, which makes it
-      easy to specify queries and browse results across a project.</p>
-    </section>
+    <p>The "find in files" feature, which allows finding and replacing
+    strings across an entire project, has been redesigned for GNOME 41. It is
+    now located in a persistent section in the bottom panel, which makes it
+    easier to find and access, and has a new search UI, which makes it easy to
+    specify queries and browse results across a project.</p>
     
-    <section id="cmake-make">
-      <title>CMake and Make Support</title>
-      <p>In GNOME 41, Builder can now build and run CMake projects. TODO: more
-      details needed here. You can just click the run button and off it will
-      go? Do you need a Flatpak manifest, or can you specify the build
-      configuration in a more generic CMake-y way?</p>
-      <p>Builder can now also build projects that use a pure Make build setup
-      in a Flatpak environment, thanks to now being able to handle
-      <cmd>make-args</cmd> and <cmd>make-install-args</cmd>.</p>
-    </section>
-
-    <section>
-      <title>Deploy to Connected Devices</title>
-      <p>Builder has had the ability to build and deploy Flatpak bundles to 
-      connected devices for some time, which is useful when developing mobile 
-      applications. With GNOME 41, this feature has been improved, and works 
-      much more automatically. To learn how to use it, see 
-      <link href="https://www.jwestman.net/2021/08/06/tutorial-mobile-dev-with-builder.html";>James Westman's 
tutorial</link>.</p>
-    </section>
+    <p>Builder can now build and run CMake projects, and it can also build 
+    projects that use a pure Make build setup in a Flatpak environment (thanks
+    to being able to handle <cmd>make-args</cmd> and
+    <cmd>make-install-args</cmd>.</p>
+
+    <p>Builder has had the ability to build and deploy Flatpak bundles to 
+    connected devices for some time, which is useful when developing mobile 
+    applications. With GNOME 41, this feature has been improved, and works 
+    much more automatically. To learn how to use it, see 
+    <link href="https://www.jwestman.net/2021/08/06/tutorial-mobile-dev-with-builder.html";>James Westman's 
tutorial</link>.</p>
     
-    <section>
-      <title>Markdown Previews</title>
-      <p>Builder has a new markdown renderer for GNOME 41, which produces much
-      better-formatted Markdown previews.</p>
-    </section>  
+    <p>Finally, Builder has a new markdown renderer for GNOME 41, which produces
+    much better-formatted Markdown previews.</p>
 
   </section>
 
@@ -155,14 +147,11 @@
     <p>There have been two minor updates to GTK 4 since the GNOME 40 release:
     4.2, and 4.4.</p>
     
-    <p>GTK 4.2 introduced NGL, a new GL renderer for GTK 4, which is now the 
-    defalut renderer on Linux, Windows and Mac. It has noticably faster 
-    improvements to frames per second, as well as power and CPU usage.  the 
-    previous GL renderer. NGL was subsequently improved in GTK 4.4, with speedups, performance 
-    fixes, and other bug fixes.</p>
-    
-    <p>Input handling has been another area for improvements in GTK, with 
-    changes in compose and dead key handling.</p>
+    <p>NGL, a new GL renderer for GTK 4, has been introduced, and is now the 
+    defalut renderer on Linux, Windows and Mac. It has noticable improvements to
+    frames per second, as well as power and CPU usage. Input handling has been
+    another area for improvements in GTK, with changes in compose and dead key
+    handling.</p>
     
     <p>Other improvements in the 4.2 and 4.4 releases include:</p>
 
@@ -187,33 +176,27 @@
     <title>libadwaita</title>
 
     <p><link href="https://gnome.pages.gitlab.gnome.org/libadwaita/";>libadwaita</link>
-    is the new GTK 4 companion library for GNOME. It provides the default GNOME 
-    GTK stylesheet, additional widgets, and convenience functionality for 
-    developers creating GTK 4 apps for the GNOME platform. It is the successor 
-    to
-    <link href="https://gnome.pages.gitlab.gnome.org/libhandy/";>libhandy</link>,
-    which can be used in combination with GTK 3, though libadwaita has a much 
-    expanded role.</p>
-
-    <p><code>libadwaita</code> has made steady progress during the GNOME 41
-    development cycle, with an initial 1.0 planned in the coming months. New 
-    developments during that time include:</p>
+    is an in-development companion library for GTK 4, which is working towards
+    an initial 1.0 release in the coming months. It will provide the GNOME GTK 
+    stylesheet, additional widgets, and convenience functionality for GTK 4 
+    GNOME apps. It is the technological successor to
+    <link href="https://gnome.pages.gitlab.gnome.org/libhandy/";>libhandy</link>
+    (which can be used in combination with GTK 3).</p>
+
+    <p><code>libadwaita</code> developments during the GNOME 41 cycle include:
+    </p>
 
     <list>
-      <item><p>There has been a substantial amount of API cleanup and code 
-      refactoring, as the library approaches its 1.0 release.</p></item>
-      <item><p>libadwaita's CSS stylesheet has seen a lot of work, with a major
-      refactoring and general style updates. Work has also been done to support
-      recoloring; this will facilitate dark mode as well as allowing apps to
-      recolor their UIs.</p></item>
-      <item><p>A new base class for apps has been added. Called
-      <code>AdwApplication</code>, this reduces repetitive code and handles 
-      library initialization.</p></item>
-      <item><p>Unread badges have been added to view switchers.</p></item>
-      <item><p>Windows now have softer, better-looking shadows.</p></item>
-      <item><p>Additional style options have been included, such as the 
-      <code>.flat</code> style for header <code>.numeric</code> style for
-      tabular figures, and the <code>.pill</code> button style.</p></item>
+      <item><p>A substantial amount of API cleanup and code refactoring, as the
+      library approaches its 1.0 release.</p></item>
+      <item><p>Significant CSS stylesheet changes, including a major
+      refactoring, general style updates, and work to support recoloring. The
+      latter will facilitate dark mode as well as allowing apps to recolor their
+      UIs.</p></item>
+      <item><p>The addition of <code>AdwApplication</code>, a new base class for
+      apps which reduces repetitive code and handles library initialization.
+      </p></item>
+      <item><p>Inclusion of unread badges in view switchers.</p></item>
       <item><p><link href="https://gnome.pages.gitlab.gnome.org/libadwaita/doc/";>API documentation</link>
       is now generated with gi-docgen.</p></item>
     </list>
@@ -276,7 +259,7 @@
 
   <section id="flatpak-sdk">
     <title>Flatpak SDK Updates</title>
-    <p>The Flatpak SDK received a number of improvements for GNOME 41:</p>
+    <p>The GNOME Flatpak SDK received a number of improvements for GNOME 41:</p>
     
     <list>
       <item><p>The Flatpak SDK is now built with sysprof support enabled, making
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]