diff --git a/xml/help_admin.xml b/xml/help_admin.xml
index 42694e769a..c7398365f7 100644
--- a/xml/help_admin.xml
+++ b/xml/help_admin.xml
@@ -14,18 +14,39 @@
- &productnamereg; comes with various sources of information and documentation,
- many of which are already integrated into your installed system.
+ &productnamereg; comes with several sources of information and documentation,
+ available online or integrated into your installed system.
+
+ Product Documentation
+
+
+ Extensive documentation for &productname; is available at . Topics covered range from
+ deployment, upgrade and system administration to virtualization, system
+ tuning and security, among others.
+
+
+ At ,
+ you can find &suse;'s best practice series of documents covering hands-on
+ documentation on implementation scenarios. At , our
+ technical reference documentation series provides guides on deploying
+ solution components from &suse; and its partners.
+
+
+ Documentation in /usr/share/doc
- This traditional help directory holds documentation files and
- release notes for your system. It contains also information of installed
- packages in the subdirectory packages. Find more
- detailed information in .
+ This directory holds release notes for your system (in the subdirectory
+ release-notes). It also contains information of
+ installed packages in the subdirectory packages. Find
+ more detailed information in .
@@ -46,9 +67,7 @@
The help center of the &gnome; desktop (&yelp;) provides central access to
- the most important documentation resources on your system in searchable
- form. These resources include online help for installed applications, man
- pages, info pages, and the &suse; manuals delivered with your product.
+ the &gnome; desktop documentation.
@@ -69,16 +88,16 @@
Documentation directory
- The traditional directory to find documentation on your
- installed Linux system is /usr/share/doc. The
- directory contains information about the packages installed on your system,
- plus release notes, manuals and more.
+ The traditional directory to find documentation on your installed Linux
+ system is /usr/share/doc. The directory contains the
+ release notes and information about the packages installed on your system,
+ plus manuals and more.
- Contents depends on installed packages
+ Contents depend on installed packages
- In the Linux world, many manuals and other kinds of documentation are
+ In the Linux world, manuals and other kinds of documentation are
available in the form of packages, like software. How much and which
information you find in /usr/share/docs also depends
on the (documentation) packages installed. If you cannot find the
@@ -87,31 +106,16 @@
-
- &suse; manuals
-
- We provide HTML and PDF versions of our books in different
- languages. In the manual subdirectory, find HTML
- versions of most of the &suse; manuals available for your product. For an
- overview of all documentation available for your product refer to the
- preface of the manuals.
-
+
+ Release notes
- If more than one language is installed,
- /usr/share/doc/manual may contain different language
- versions of the manuals. The HTML versions of the &suse; manuals are also
- available in the help center of both desktops. For information on where to
- find the PDF and HTML versions of the books on your installation media,
- refer to the &productname; Release Notes. They are available on your
- installed system under /usr/share/doc/release-notes/
- or online at your product-specific Web page at .
+ We provide HTML, PDF, RTF and text versions of &productname; release
+ notes. They are available on your installed system under
+ /usr/share/doc/release-notes/ or online at your
+ product-specific Web page at .
-
@@ -142,7 +146,7 @@
- Known bugs or malfunctions. Might also contain a link to a Bugzilla Web
+ Known bugs or malfunctions. May also contain a link to a Bugzilla Web
page where you can search all bugs.
@@ -205,7 +209,7 @@
- Things that are not implemented yet, but might be in the future.
+ Features planned for the future.
@@ -384,10 +388,10 @@
- Each man page consists of several parts labeled NAME
- , SYNOPSIS , DESCRIPTION ,
- SEE ALSO , LICENSING , and
- AUTHOR . There may be additional sections available
+ Each man page consists of several parts labeled NAME,
+ SYNOPSIS, DESCRIPTION,
+ SEE ALSO, LICENSING, and
+ AUTHOR. There may be additional sections available
depending on the type of command.
@@ -440,7 +444,7 @@
- &productname; user community
+ User community
&opensuse;
@@ -473,7 +477,7 @@
The Linux Documentation Project (TLDP) is run by a team of volunteers who
write Linux-related documentation (see
- ). It is probably the most
+ ). It is the most
comprehensive documentation resource for Linux. The set of documents
contains tutorials for beginners, but is mainly focused on experienced
users and professional system administrators. TLDP publishes HOWTOs,
@@ -483,12 +487,5 @@
-
-
- You can also try general-purpose search engines. For example, use the search
- terms Linux CD-RW help or OpenOffice file
- conversion problem if you have trouble with burning CDs or &libo;
- file conversion.
-