<p>Fedora Docs Team Members:</p><br>One area which appears to be overlooked is the installation and <br>updating of software by the novice user. Various sections exist (such<br>as the excellent one on <span style="font-style: italic;">
yum</span> - see <a href="http://fedoraproject.org/wiki/Tools/yum">http://fedoraproject.org/wiki/Tools/yum</a>),<br>but there is no "gentle introduction" for the person new to Fedora Core.<br><br>According to the Documentation Summary section of the 
<span style="font-style: italic;">Desktop User Guide</span>:<br><br><quote><br><p><em><span style="font-style: italic;"></span>Assumptions:</em> The reader has a standard Desktop class
installation of Fedora.<br>The reader has a user account with the default
settings.The reader does <strong>not</strong><br>have access to the <em>root</em> password. <br></p>
<p><em>Related Documents</em>: The <a href="http://fedoraproject.org/wiki/Docs/Drafts/AdministrationGuide">AdministrationGuide</a> documents tasks that require<br><em>root</em> access. The <a href="http://fedoraproject.org/wiki/Docs/Drafts/GettingStartedGuide">
GettingStartedGuide</a>
is a general introduction to using Fedora.<br>Each desktop application has
integrated Help, so the scope of this document<br>may need to be
considered carefully. <br></p><p><end-quote><br></p>I agree with the DUG assumption not requiring the novice user to have access<br>to the root password. This keeps the DUG focused on the basics.<br><p>However, a quick review of the 
<span style="font-style: italic;">Administration Guide</span> reveals no section on the<br>installation and updating of packages. <br></p><p>The <span style="font-style: italic;">Getting Started Guide</span> has the following section:
</p><p><quote><br></p>Cool Things To Do with Fedora

<p>Everything above gives users equivalents to a standard Windows
desktop that<br>they have seen before. What cool things can new users try
with a Fedora<br>system that take them further ? </p>
<ul><li><p> <a class="nonexistent" href="http://fedoraproject.org/wiki/LinPhone">LinPhone</a> - demonstrates installing from Extras, and free phone calls. Requires: headset. </p>
</li><li class="gap"><p> <a class="nonexistent" href="http://fedoraproject.org/wiki/GnuCash">GnuCash</a> - installs from Core, home finance software isn't cool, but is important.</p></li></ul><end-quote><br><p>However, the links for installing 
<span style="font-style: italic;">LinPhone</span> and <span style="font-style: italic;">GnuCash </span>don't link to existing pages.</p><p>A MODEST PROPOSAL<br></p><p>Therefore, I propose a separate <span style="font-style: italic;">
Installing and Updating Software Guide</span> aimed<br>at the beginning Fedora Core user.  I volunteer to write and edit the guide and<br>welcome any and all contributions and suggestions. (That includes a better<br>name for this guide). We would start from the Fedora Core 6 release.
<br></p><p>This assumes, of course, that I get the "go ahead" from the Powers That Be.</p><p>PROPOSED OUTLINE FOR THE IAUSG<br></p><p>These would be the assumptions for the <span style="font-style: italic;">Installing and Updating Software Guide
</span>:</p><p><em><span style="font-style: italic;"></span>Assumptions:</em> The reader has a standard Desktop class
installation of Fedora.<br>
The reader has a user account with the default
settings.The reader <strong></strong><span style="font-weight: bold;">has</span> access<br>to the <em>root</em> password. The reader has access to the internet (preferably broadband).<br>The reader does not have a degree in Computer Science.
</p><p>We need to give some background information and provide concepts and details<br>as required.<br></p>
<p>As suggested by the <span style="font-style: italic;">Getting Started Guide, </span>we can demonstrate different classes of<br>installs, such as from the Core and Extras repositories. <br></p><p>We should also demonstrate different methods of installing packages,
<br>going from the simplest to the more complex.</p><p>1. Install a package like <span style="font-style: italic;">xmms</span> using <span style="font-style: italic;">Pirut. </span>(Perhaps <span style="font-style: italic;">
xmms</span> with <span style="font-style: italic;">fluendo?</span>)<span style="font-style: italic;"><br></span></p><p>2<span style="font-style: italic;">. </span>Install <span style="font-style: italic;">Yumex</span> via 
<span style="font-style: italic;">Pirut</span>, and then install (perhaps a game) via <span style="font-style: italic;">yumex.</span></p><p>3<span style="font-style: italic;">. </span>Use <span style="font-style: italic;">
rpm</span> from the <span style="font-style: italic;">CLI</span> to view a list installed packages (no <span style="font-style: italic;">root</span> password required).</p><p>4.<span style="font-style: italic;"> </span>Use 
<span style="font-style: italic;">rpm </span>to install a locally available package (<span style="font-style: italic;">root </span>password required).</p><p>5. Use <span style="font-style: italic;">yum</span> to install a package from an internet repository.
</p><p>6. Use <span style="font-style: italic;">yum</span> to provide various reports.</p><p>7. Use <span style="font-style: italic;">yum</span> to do a group-level installation, such as a complete KDE<br>    desktop installation.
</p><p>8. More advanced topics:<br>   a. Using <span style="font-style: italic;"><span style="font-style: italic;">smart.<br></span></span>   b. Using <span style="font-style: italic;"><span style="font-style: italic;">apt-get.
<br><span style="font-style: italic;">   </span></span></span>c. Using<span style="font-style: italic;"><span style="font-style: italic;"> yum </span></span>at installation time via the new <span style="font-style: italic;">
anaconda</span> feature.<span style="font-style: italic;"><span style="font-style: italic;"><br></span></span></p><p>Likewise, we should cover the topic of updating packages in a similar<br>progression from the simple to the advanced.
</p><p>1. Update packages using <span style="font-style: italic;">Pirut.</span></p>
<p>2.<span style="font-style: italic;"> </span>Update<span style="font-style: italic;"></span><span style="font-style: italic;"></span> using <span style="font-style: italic;">Yumex.</span></p><p>3.<span style="font-style: italic;">
 </span>Update using <span style="font-style: italic;">yum</span> from the <span style="font-style: italic;">CLI</span>.<span style="font-style: italic;"><br></span></p><p>4. Selectively update using <span style="font-style: italic;">
yum</span> (including/excluding packages<br>    and disabling/enabling repositories).</p><p>5.<span style="font-style: italic;"> </span>More advanced topics:<span style="font-style: italic;"><br> </span>  a. Do a complete Fedora Core release upgrade (I actually have done
<br>
       this successfully on a laptop with a bad CD drive and broadband<br>
       internet access.)</p>
<p>FURTHER READING (RELATED DOCUMENTS)<br></p><p>As always, we should provide pointers to good links, both inside and<br>outside of the Fedora Core wiki.</p><p>FLOSS AND COTS PACKAGES<br></p><p>Additionally, we should stick with FLOSS software and avoid packages
<br>which violate the GPL. At the same time, we should remember that there<br>are legal, commercially available packages which can be covered in<br>general terms. Most of these commercial-off the-shelf (COTS) packages<br>
come with detailed instructions and/or installation scripts, so this<br>section can be short.</p><p>This guide should follow the guidelines and policies for the Fedora<br>Core wiki concerning "forbidden items" (not my favorite term). See
<br><a href="http://fedoraproject.org/wiki/ForbiddenItems">http://fedoraproject.org/wiki/ForbiddenItems.<span style="text-decoration: underline;"><span style="text-decoration: underline;"><br></span></span></a></p><p>(Aside: Maybe we can come up with a less harsh-sounding phrase than
<br>"forbidden items".)</p><p>In conclusion, ala Rod Serling's <span style="text-decoration: underline; font-style: italic;">Twilight Zone</span>, this is submitted "for your<br>consideration."</p>John Babich
<br><p><br></p><p><br><span style="font-style: italic;"><span style="font-style: italic;"></span></span></p><p><br></p>