Re: Topics for review (gnome desktop help)

[Phil Bull <philbull gmail com>]

Hi April

Sorry for sitting on these for a week. I've returned them with some
comments. As usual, they all look good (just a couple of nitpicks).

Thanks,

Phil

-- 
Phil Bull
https://launchpad.net/~philbull
Book - http://nostarch.com/ubuntu4.htm

<page xmlns="http://projectmallard.org/1.0/";
      type="topic" id="look-theme-icons">

  <info>
    <link type="guide" xref="look"/>
    
    <desc>How to change system icons</desc>
    <revision pkgversion="0.1" version="0.1" date="2010-07-26" status="stub"/>
    
    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list gnome org</email>
    </credit>
    <credit type="author">
      <name>April Gonzales</name>
      <email>loonycookie gmail com</email>
    </credit>
    
  </info>

<title>Use a different set of icons</title>
<p>Personalizing your desktop is not limited to changing themes and desktop backgrounds. You can change the icons you use for your system as well. To do this:</p>

<!-- Might be good to have a small screenshot showing a few icons before and after a change of icon set. Maybe with an arrow showing the change. -->

<steps>
<item><p>Go to <guiseq><gui>System</gui><gui>Preferences</gui><gui>Appearance</gui></guiseq>.</p></item>

<item><p>Under the <gui>Theme</gui> tab, select the the theme you are currently using.</p></item>
<!-- No need to select the current theme, it should be selected by default anyway -->

<item><p>Click on the <gui>Customize</gui> button. </p></item>

<item><p>Under the <gui>Customize Theme</gui> window, click on the <gui>Icons</gui> tab. Select the icon theme you wish to use.</p></item>
<item><p>Click <gui>Close</gui> to go back to the <gui>Appearance Preferences</gui> window.</p></item>
<item><p>Click <gui>Close</gui>.</p></item>
<!-- No need to tell the reader to close the window, they'll figure it out -->
</steps>

<note>
<p>
All changes made will be automatically reflected on your system.
</p>
</note>
</page>

<page xmlns="http://projectmallard.org/1.0/";
      type="topic" id="look-fonts-toobig">

  <info>
    <link type="guide" xref="look"/>
    
    <desc>How to change the screen resolution</desc>
    <revision pkgversion="0.1" version="0.1" date="2010-07-26" status="stub"/>
    
    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list gnome org</email>
    </credit>
    <credit type="author">
      <name>April Gonzales</name>
      <email>loonycookie gmail com</email>
    </credit>
    
  </info>

<title>Why does everything on my screen look so big?</title>

<p>Your font resolution settings may be set very high. You can change it to a lower setting to make the font appear smaller. To do so: </p>

<steps>
<item><p>Select <guiseq><gui>System</gui><gui>Preferences</gui><gui>Appearance</gui></guiseq>.</p></item>
<item><p>Select the <gui>Fonts</gui> tab.</p></item>
<item><p>Click on the <gui>Details</gui> button. This brings up the <gui>Font Rendering Details</gui> window.</p></item>
<item><p>On the field next to the label <gui>Resolution</gui>, type in the font resolution you wish to use. Remember that using a lower number decreases the size of the font. </p></item>
<!-- Readers really need guidance on appropriate settings here. I gather that 96dpi is usual, but some screens use 120dpi. Netbooks etc. might have different settings still. -->
<item><p>Click the <gui>Close</gui> button to go back to the <gui>Appearance Preferences</gui> window.</p></item>
<item><p>Click <gui>Close</gui>.</p></item>
<!-- No need for last list item, it's obvious -->

<note>
<p>
All changes made are automatically reflected. 
</p>
</note>
<!-- Probably no need for this note, the user will find out that this is the case straight away. -->
Resolution, font resolution (Appearance -> Fonts -> Details)

</steps>
</page>

<page xmlns="http://projectmallard.org/1.0/";
      type="topic" id="look-theme-custom">

  <info>
    <link type="guide" xref="look"/>
    
    <desc>How to customize a theme</desc>
    <!-- Description could reinforce the title more (at the moment, it's too similar to the title) -->
    <revision pkgversion="0.1" version="0.1" date="2010-07-26" status="stub"/>
    
    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list gnome org</email>
    </credit>
    <credit type="author">
      <name>April Gonzales</name>
      <email>loonycookie gmail com</email>
    </credit>
    
  </info>

<title>Customize a theme</title>
<p>You can customize any one of the available themes on your system. To do so:</p>
<!-- Might be good to give a quick overview (half a sentence!) on what you can customise in the theme -->
<steps>
<item><p>Select <guiseq><gui>System</gui><gui>Preferences</gui><gui>Appearance</gui></guiseq>.</p></item>
<item><p>Under the <gui>Theme</gui> tab, select the theme you want to customize.</p></item>
<item><p>Click on the <gui>Customize</gui> button. This brings up the <gui>Customize Theme</gui> window.</p></item>
<item><p>To change the control elements of the theme, click on the <gui>Control</gui> tab and select the style you wish to use.</p></item> 
<!-- I think "control elements" is jargon. Is there a way of giving the reader more of a feel for what these are? I'm not sure if non-technical users even think of controls as separate objects. -->
<item><p>To change the system colors, click on the <gui>Colors</gui> tab. From here, you can modify the background and text colors for the Windows, Input boxes, Selected Items, and Tool tips. Just click on the button that corresponds to the element you wish to change and select a color from the available options.</p></item>
<item><p>To change the style of the window border, click on the <gui>Window Border</gui> tab and select the the border style you wish to use.</p></item>
<item><p>To change the icons, click on the <gui>Icons</gui> tab. Select the icon set you wish to use in your customized theme.</p></item>
<item><p>To change the appearance of the mouse pointer, click on the <gui>Pointer</gui> tab and select the pointer style you wish to use.</p></item>
<item><p>Click <gui>Close</gui> to go back to the <gui>Appearance Preferences</gui> window.</p></item>
<item><p>Click <gui>Close</gui>.</p></item>
<!-- No need to tell the user to click Close, they'll figure it out -->
</steps>
<note>
<p>
All of the changes made are automatically applied to the system.
</p>
</note>
</page>

<page xmlns="http://projectmallard.org/1.0/";
      type="topic" id="look-theme-online">

  <info>
    <link type="guide" xref="look"/>
    
    <desc>How to download themes from the internet</desc>
    <revision pkgversion="0.1" version="0.1" date="2010-07-26" status="stub"/>
    
    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list gnome org</email>
    </credit>
    <credit type="author">
      <name>April Gonzales</name>
      <email>loonycookie gmail com</email>
    </credit>
    
  </info>

<title>Get new themes from the internet</title>
<p>Your system comes with many optional themes; however, you may also download more from many sources online. To do this:</p>

<steps>
<item><p>Visit a website that lists downloadable desktop elements such as themes, wallpapers, and icons for your desktop. One excellent source is www.gnome-look.org. </p></item>
<!-- Could use a link to gnome-look here. Syntax is: <link href="http://www.example.com";>Link text</link> -->
<item><p>Select from one of the many themes available. </p></item>
<item><p>Download the theme you have selected and save it on your computer. It may come in a .zip file or a tar.gz file. If it comes in a zip file, extract the contents until you come to a tar.gz file. If you download a tar.gz file, leave it as is.</p></item>
<item><p>To install the theme, go to <guiseq><gui>System</gui><gui>Preferences</gui><gui>Appearance</gui></guiseq>. Under the <gui>Theme</gui> tab, click on the <gui>Install</gui> button.</p></item> 
<item><p>Navigate to the location of the downloaded theme.</p></item>
<item><p>Select the downloaded theme and click <gui>Open</gui>. This installs the theme. You can also drag and drop the tar.gz files into the theme selector window (<guiseq><gui>System</gui><gui>Preferences</gui><gui>Appearance</gui><gui>Theme tab</gui></guiseq>).</p></item>
</steps>

<!-- You should also be able to drag and drop the .tar.gz theme file into the Appearances window to install it. -->

<p>To use the theme, simply select it and the changes will be reflected on your desktop automatically.</p>

</page>