gnucash-docs maint: Further improvements of getting help
Frank H.Ellenberger
fell at code.gnucash.org
Tue Apr 6 23:36:32 EDT 2021
Updated via https://github.com/Gnucash/gnucash-docs/commit/2651ea27 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/9e3fc7aa (commit)
commit 2651ea27a9bebf26bf174c7a12dab644573e32d6
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Wed Apr 7 04:25:39 2021 +0200
Further improvements of getting help
Webserver: more details
several minor changes like NNTP
diff --git a/docbook/gnc-docbookx.dtd b/docbook/gnc-docbookx.dtd
index 9076eae..3b6e26d 100644
--- a/docbook/gnc-docbookx.dtd
+++ b/docbook/gnc-docbookx.dtd
@@ -92,7 +92,8 @@ own entity definitions to use across all of our DocBook pages. -->
<!ENTITY url-logs-irc "https://lists.gnucash.org/logs/"> <!-- for IRC. If someone needs build logs, scan https://code.gnucash.org/builds/ -->
<!ENTITY url-mail-ar "https://lists.gnucash.org/pipermail/"> <!-- Append <list>/<Year>-<Monthname>/<Number>.html -->
<!ENTITY url-mail-li "https://lists.gnucash.org/mailman/listinfo/"> <!-- Append the desired list -->
-<!ENTITY url-mail-nabble "http://gnucash.1415818.n4.nabble.com/GnuCash-User-f1415819.html">
+<!ENTITY url-mail-nabble "http://gnucash.1415818.n4.nabble.com/GnuCash-f1415818.subapps.html">
+<!ENTITY url-mail-gmane "nntp://news.gmane.org/gmane.comp.gnome.apps.gnucash.user">
<!ENTITY url-src "https://github.com/Gnucash/gnucash/">
<!ENTITY url-src-maint "https://github.com/Gnucash/gnucash/tree/maint/"> <!-- Append the desired topic -->
<!ENTITY url-wiki "https://wiki.gnucash.org/wiki/"> <!-- You could append the desired topic, but better create a separate entity. -->
diff --git a/help/C/Help_ch_GettingHelp.xml b/help/C/Help_ch_GettingHelp.xml
index 149379d..e5d14fd 100644
--- a/help/C/Help_ch_GettingHelp.xml
+++ b/help/C/Help_ch_GettingHelp.xml
@@ -116,13 +116,27 @@
<!-- Translators: if wiki pages in your language exist, add or replace the links in this section
see also https://wiki.gnucash.org/wiki/Special:Categories for your language or region code -->
<para>An immense amount of less-formal, but often <emphasis>more recent</emphasis>
- documentation, both of &app; itself and its maintenance and development may be
- found in the <ulink url="&url-wiki;">&app; Wiki</ulink> ; the
+ documentation about as well usage as development of &app; is collected
+ by the community in the <ulink url="&url-wiki;">&app; Wiki</ulink> ; the
<ulink url="&url-wiki-faq;">Frequently Asked Questions</ulink>
page should be a first stop whenever you encounter difficulty using &app;.</para>
<tip><para>You should also try its
<ulink url="&url-wiki-search;">search page</ulink> or <ulink url="&url-wiki-category;">browse categories</ulink>.</para></tip>
</sect2>
+
+ <sect2 id="website">
+ <title>&app; Website</title>
+
+ <para>The multilingual <ulink url="&url-www;">&app; website</ulink> contains:<variablelist spacing="compact">
+ <varlistentry><term>Announcements</term>
+ <listitem><simpara>of new releases or server maintenance – usually only in English;</simpara></listitem></varlistentry>
+ <varlistentry><term>Downloads</term>
+ <listitem><simpara>of the program or the documentation in several flavours;</simpara></listitem></varlistentry>
+ <varlistentry><term>Links</term>
+ <listitem><simpara>to file bugs or suggest enhancements and more.</simpara></listitem></varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
<sect2 id="more_help">
<title>&app; On-line Assistance</title>
@@ -135,32 +149,32 @@
If English is not your primary language, see
<ulink url="&url-wiki-ml;#User_Lists">wiki:user mailing lists</ulink> for local lists.
That page has also other useful sections like
- <ulink url="&url-wiki-ml;#Netiquette">Netiquette</ulink> or
+ <ulink url="&url-wiki-ml;#Netiquette">Netiquette</ulink> or your individual
<ulink url="&url-wiki-ml;#Mailing_List_Management">Mailing List Management</ulink>.</para>
<!-- Translators: Nabble has only a few Gnucash lists. Verify that your languages is supported. -->
- <para>If you prefer a web forum-like presentation, you can use a 3rd party service like
- <ulink url="&url-mail-nabble;">Nabble</ulink>.</para>
+ <para>In case you are old school there are <emphasis>3rd party services</emphasis> which convert some of the lists into other formats:<variablelist spacing="compact">
+ <varlistentry><term>Web Forum</term>
+ <listitem><simpara><ulink url="&url-mail-nabble;">Nabble</ulink>;</simpara></listitem></varlistentry>
+ <varlistentry><term>NNTP News Feed</term>
+ <listitem><simpara><ulink url="nntp://news.gmane.org/gmane.comp.gnome.apps.gnucash.user">Gmane</ulink>.</simpara></listitem></varlistentry>
+ </variablelist>
+ </para>
<para>One must <ulink url="&url-mail-li;gnucash-user">subscribe</ulink>
- before posting, even if using Nabble.</para>
+ before posting, even if using Nabble or Gmane.</para>
- <bridgehead>IRC</bridgehead>
+ <bridgehead>Chat</bridgehead>
<para>Several of the developers and experienced users monitor the
<ulink url="&url-irc;">#gnucash channel at irc.gnome.org</ulink>.
They're usually doing something else, too, and of course aren't always at their
computers. Log in, ask your question, and stay logged in; it may
- take several hours before your question is noticed and responded.
- To see if you missed anything
- <ulink url="&url-logs-irc;">check the IRC logs</ulink>.
- Requirements, netiquette and other details are explained in the
- <ulink url="&url-wiki-irc;">IRC wiki page</ulink>.</para>
- </sect2>
-
- <sect2 id="website">
- <title>&app; Website</title>
-
- <para>The <ulink url="&url-www;">&app; website</ulink>
- has more details on these channels. You will also find pointers there
- to additional useful resources such as the bug tracking system.</para>
+ take several hours before your question is noticed and responded.<itemizedlist>
+ <listitem><simpara>If you got disconnected
+ <ulink url="&url-logs-irc;">check the IRC logs</ulink> to verify that you missed nothing.</simpara>
+ </listitem>
+ <listitem><simpara>Requirements, netiquette, and other details are explained in the
+ <ulink url="&url-wiki-irc;">IRC wiki page</ulink>.</simpara></listitem>
+ </itemizedlist>
+ </para>
</sect2>
</sect1>
</chapter>
Summary of changes:
docbook/gnc-docbookx.dtd | 3 ++-
help/C/Help_ch_GettingHelp.xml | 54 ++++++++++++++++++++++++++----------------
2 files changed, 36 insertions(+), 21 deletions(-)
More information about the gnucash-changes
mailing list