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. -