[gnome-devel-docs] compatibility page - minor refinements

[Allan Day <allanday src gnome org>]

commit 5931e23e38891f296ca6a920b13dc622d150c4eb
Author: Allan Day <allanpday gmail com>
Date:   Wed Jul 15 17:50:10 2015 +0100

    compatibility page - minor refinements

 hig/C/compatibility.page |   16 ++++++++--------
 1 files changed, 8 insertions(+), 8 deletions(-)
---
diff --git a/hig/C/compatibility.page b/hig/C/compatibility.page
index 8dc7a7d..79f825b 100644
--- a/hig/C/compatibility.page
+++ b/hig/C/compatibility.page
@@ -18,7 +18,7 @@
 <section id="cross-platform-compatibility">
 <title>Cross-platform compatibility</title>
 
-<p>Cross-platform guidance is provided for those design patterns and UI elements that require special 
treatment in cross-platform cases. Otherwise, all the design patterns provided in these guidelines can be 
used in a cross-platform manner.</p>
+<p>The HIG provides cross-platform for those design patterns and UI elements that require special treatment 
in cross-platform cases. Otherwise, all the design patterns provided in these guidelines can be used in a 
cross-platform manner.</p>
 
 <p>Since some platforms provide system-level integration for <link xref="menu-bars">menu bars</link>, this 
pattern is of special relevance for cross-platform applications.</p>
 
@@ -27,20 +27,20 @@
 <section id="gnome-2-compatibility">
 <title>GNOME 2 Compatibility</title>
 
-<p>These Human Interface Guidelines are an evolution of the GNOME 2 HIG. The design patterns provided 
improve upon the previous version of the HIG, and encourage more modern application design. Applications that 
follow this version of the HIG will use space more efficiently, provide a more focused user experience, and 
will use modern interpretations of key functionality, such as search, online integration, or 
notifications.</p>
+<p>These Human Interface Guidelines are an evolution of the GNOME 2 HIG, and represent an improvement on the 
previous version. Applications that follow the new version of the HIG will use space more efficiently, will 
provide a more focused user experience, and will use modern interpretations of key functionality, such as 
search, online integration, or notifications.</p>
 
-<p>Much of the advice contained within this HIG can be incorporated into GNOME 2 style applications with 
minimal disruption, and will lead to an improved experience for users. This includes:</p>
+<p>Following some of the design patterns in these guidelines may imply larger-scale design changes for GNOME 
2 style applications, particularly if those applications are complex. In particular, replacing window title 
bars and <link xref="menu-bars">menu bars</link> with a <link xref="header-bars">header bar</link> could be a 
big change for your application.</p>
+
+<p>However, much of the advice contained within this HIG can be incorporated into GNOME 2 style applications 
with minimal disruption, and will lead to an improved experience for users. This includes:</p>
 
 <list>
-<item><p>New user interface elements, such as popovers.</p></item>
-<item><p>Improved GTK+ abilities, like animations.</p></item>
-<item><p>Updated guidance on subjects such as visual layout, typography and icon usage.</p></item>
+<item><p>Utilizing new user interface elements, such as popovers.</p></item>
+<item><p>Guidance on new GTK+ abilities, like animations.</p></item>
+<item><p>Modernized guidance on subjects such as visual layout, typography and icon usage.</p></item>
 </list>
 
 <p>Incorporating these elements of the guidelines can enhance your application without requiring a major 
redesign, and all GTK+ and GNOME applications can benefit from them.</p>
 
-<p>At the same time, following some of the design patterns in these guidelines may imply larger-scale design 
changes for GNOME 2 style applications, particularly if those applications are complex. In particular, 
replacing window title bars and <link xref="menu-bars">menu bars</link> with a <link 
xref="header-bars">header bar</link> could be a big change for your application.</p>
-
 <p>These Human Interface Guidelines have been designed to assist you in determining the best design for your 
application, rather than proposing a single template to be used in all applications. As such, while they 
recommend <link xref="header-bars">header bars</link> over <link xref="menu-bars">menu bars</link>, they 
provide guidance on both approaches.</p>
 
 </section>