From 7400e95b2e106b184691a1366b330fb6ec46c2e9 Mon Sep 17 00:00:00 2001 From: Frank Sundermeyer Date: Thu, 27 Jul 2023 15:08:49 +0200 Subject: [PATCH] Fix for bsc#1213642 * manuals are only available online * added info on release notes * fixed contents of GNOME help center --- xml/help_admin.xml | 92 ++++++++++++++++++++++++---------------------- 1 file changed, 48 insertions(+), 44 deletions(-) diff --git a/xml/help_admin.xml b/xml/help_admin.xml index 42694e769a..2631c8dcdc 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 . Among others, topics covered range from + deployment, upgrade, and system administration to virtualization, system + tuning, and security. + + + At + you 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 - 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. @@ -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,