[haiku-commits] Change in haiku[master]: HIG doc: Fix typos etc.

  • From: Gerrit <review@xxxxxxxxxxxxxxxxxxx>
  • To: waddlesplash <waddlesplash@xxxxxxxxx>, haiku-commits@xxxxxxxxxxxxx
  • Date: Fri, 9 Oct 2020 06:21:41 +0000

From humdinger <humdingerb@xxxxxxxxx>:

humdinger has uploaded this change for review. ( 
https://review.haiku-os.org/c/haiku/+/3298 ;)


Change subject: HIG doc: Fix typos etc.
......................................................................

HIG doc: Fix typos etc.

Fixes #16562
---
M docs/interface_guidelines/index.xml
1 file changed, 13 insertions(+), 13 deletions(-)



  git pull ssh://git.haiku-os.org:22/haiku refs/changes/98/3298/1

diff --git a/docs/interface_guidelines/index.xml 
b/docs/interface_guidelines/index.xml
index 0000c61..50c4b52 100644
--- a/docs/interface_guidelines/index.xml
+++ b/docs/interface_guidelines/index.xml
@@ -369,7 +369,7 @@
 <title>Avoid Hardcoded File Paths</title>

 <para>Whenever your program needs to specify a particular location on the
-       system, use of the find_directory() function to generate it. If and 
when the
+       system, use the find_directory() function to generate it. If and when 
the
        day comes that Haiku supports multiple users, your application will 
make a
        smooth transition to the new architecture. This will also allow for 
backward
        compatibility with older versions of BeOS, such as the change in 
locations
@@ -378,7 +378,7 @@
 </sect1>

 <sect1>
-<title>Make Your App's Look Fits in with Others</title>
+<title>Make Your App's Look Fit in with Others</title>

 <para>Certain function calls have been provided in the API to aid in making 
sure
        that your software shares the same general look as other applications 
and
@@ -479,10 +479,10 @@
        use them. If just a certain type of entry is needed, such as a
        folder or specific type of file, make a filter that shows only those 
types
        of entries. By removing unneeded items from the file navigation window, 
you
-       are reducing the number of choices the user must pick from and also
-       preventing him from opening the wrong kinds of files. Keep in mind that
+       are reducing the number of choices the users must pick from and also
+       preventing them from opening the wrong kinds of files. Keep in mind that
        there may be files that may not have had their MIME type identified, so 
do
-       not exclude them, either. You can also make Tracker show a window for a
+       not exclude them either. You can also make Tracker show a window for a
        particular folder in order to show the user where a particular file has 
been
        stored and give them access to it directly.</para>
 </sect1>
@@ -632,8 +632,8 @@
        away that something is and how big it is. While it might seem obvious, 
this
        is often overlooked when a program is designed. The easiest places for a
        user to click are the four corners of the screen and the pixel directly
-       under the cursor. The reason for this is because the mouse need not be 
moved
-       for to click on the pixel under it and the user does not have to think 
much
+       under the cursor. The reason for this is because the mouse does not 
need to be
+       moved to click on the pixel under it. The user also does not have to 
think much
        when moving the cursor to a corner because as soon as it reaches an 
edge, it
        can go no farther in that direction regardless of how much the mouse is
        moved. The Deskbar is in one corner of the screen for this 
reason.</para>
@@ -760,7 +760,7 @@
                the clipboard is in as generalized a form as possible.

        <segmentedlist>
-       <segtitle>Field 
Type</segtitle><segtitle>Name</segtitle><segtitle>Descriptions</segtitle>
+       <segtitle>Field 
Type</segtitle><segtitle>Name</segtitle><segtitle>Description</segtitle>
        
<seglistitem><seg>B_STRING_TYPE</seg><seg>class</seg><seg>"BBitmap"</seg></seglistitem>
        <seglistitem><seg>B_RECT_TYPE</seg><seg>_frame</seg><seg>A BRect 
containing the bounds of the bitmap data in pixels</seg></seglistitem>
        <seglistitem><seg>B_INT32_TYPE</seg><seg>_cspace</seg><seg>The 
color_space constant for the image data, such as B_RGBA32</seg></seglistitem>
@@ -787,15 +787,15 @@
        some guidelines for using them, however.

 <orderedlist>
-<listitem>It is appropriate for program to be a replicant if it is a 
lightweight
+<listitem>It is appropriate for a program to be a replicant if it is a 
lightweight
        program which provides information or a feature which the user will 
want to
        be able to access frequently.</listitem>

-<listitem>Allow for the size of the dragger handle when computing 
layout</listitem>
+<listitem>Allow for the size of the dragger handle when computing 
layout.</listitem>

 <listitem>Be sure it is big enough to not get lost when placed on a busy 
desktop
-       background. At the same time, do not take over the user's desktop 
unless he
-       wants this to happen. 32 pixels square is a good minimum size, for
+       background. At the same time, do not take over the user's desktop 
unless they
+       want this to happen. 32 pixels square is a good minimum size, for
        example.</listitem>

 <listitem>Provide a reliable way for the user to control your replicant. Do not
@@ -805,7 +805,7 @@
        (with either button) and there are no other clickable 
controls.</listitem>

 <listitem>Place a frame around the replicant's border so that it stands out 
from
-       its surroundings</listitem>
+       its surroundings.</listitem>

 <listitem>Do not make it too visually distracting. This mainly amounts to
        avoiding lots of bright colors for the controls and limiting the amount 
of

--
To view, visit https://review.haiku-os.org/c/haiku/+/3298
To unsubscribe, or for help writing mail filters, visit 
https://review.haiku-os.org/settings

Gerrit-Project: haiku
Gerrit-Branch: master
Gerrit-Change-Id: I866512b4254bdeb4287b6dd41aca74a76f78c3ca
Gerrit-Change-Number: 3298
Gerrit-PatchSet: 1
Gerrit-Owner: humdinger <humdingerb@xxxxxxxxx>
Gerrit-MessageType: newchange

Other related posts: