library-web r454 - in trunk: . data/pages/C
- From: fpeters svn gnome org
- To: svn-commits-list gnome org
- Subject: library-web r454 - in trunk: . data/pages/C
- Date: Sat, 17 May 2008 19:18:27 +0000 (UTC)
Author: fpeters
Date: Sat May 17 19:18:26 2008
New Revision: 454
URL: http://svn.gnome.org/viewvc/library-web?rev=454&view=rev
Log:
* data/pages/C/libgo.xml: added a feedback section with informations
on how to report bugs and how to request for new documentation to be
added, with some details about the way it works. (closes: #505863)
Modified:
trunk/ChangeLog
trunk/data/pages/C/libgo.xml
Modified: trunk/data/pages/C/libgo.xml
==============================================================================
--- trunk/data/pages/C/libgo.xml (original)
+++ trunk/data/pages/C/libgo.xml Sat May 17 19:18:26 2008
@@ -1,7 +1,6 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
- <!ENTITY date "July 2007">
]>
<article id="index" lang="en">
@@ -16,10 +15,18 @@
<firstname>Goran</firstname>
<surname>Rakic</surname>
</author>
+ <author>
+ <firstname>Frederic</firstname>
+ <surname>Peters</surname>
+ </author>
</authorgroup>
<revhistory>
<revision>
+ <revnumber>GNOME Library Help v1</revnumber>
+ <date>May 2008</date>
+ </revision>
+ <revision>
<revnumber>GNOME Library Help v0</revnumber>
<date>July 2007</date>
</revision>
@@ -30,16 +37,21 @@
</abstract>
</articleinfo>
- <sect1 id="about">
+ <section id="about">
<title>About library.gnome.org</title>
<para>
library.gnome.org aims to be the central place for documentation related
to the GNOME project, be it for users, system administrators or
developers.
</para>
- </sect1>
- <sect1 id="langinfo">
+ <para>
+ Its development tree is hosted on GNOME subversion, in the library-web
+ module.
+ </para>
+ </section>
+
+ <section id="langinfo">
<title>This web site in different languages</title>
<para>
When you request a document from a server, your language preference is
@@ -48,7 +60,7 @@
very important to setup your browser language preference correctly.
</para>
- <sect2>
+ <section>
<title>What to do if page is in wrong language</title>
<para>
@@ -83,9 +95,9 @@
change language manualy by clicking on a link. The next time you click
on link to another page, your language selection will be preserved.
</para>
- </sect2>
+ </section>
- <sect2>
+ <section>
<title id="setup-language-settings">How to set up the language settings</title>
<para>
@@ -109,7 +121,7 @@
</varlistentry>
<varlistentry>
- <term>Firefox</term>
+ <term>Firefox / Iceweasel</term>
<listitem><para>
<menuchoice>
<guimenu>Tools</guimenu>
@@ -204,10 +216,10 @@
</variablelist>
- </sect2>
+ </section>
- <sect2>
- <title>About translation</title>
+ <section>
+ <title>About translations</title>
<para>
All translations are available as an effort of <ulink
@@ -215,8 +227,58 @@
Project (GTP)</ulink>.
</para>
- </sect2>
+ </section>
- </sect1>
-</article>
+ </section>
+
+ <section id="feedback">
+ <title>Feedback</title>
+
+ <para> This section contains information on reporting bugs about this
+ website and requesting for new documents to be added. </para>
+
+ <para> If you have found a bug on this website, please report it!
+ Developers do read all the bug reports and try to fix these bugs. Please
+ try to be as specific as possible when describing the circumstances under
+ which the bug shows (what was the URL?, which browser are you using?, do
+ you have cookies enabled?). If there were any error messages, be sure to
+ include them, too. </para>
+
+ <para> You can submit bugs and browse the list of known bugs by connecting
+ to the <ulink type="http" url="http://bugzilla.gnome.org/">GNOME bug
+ tracking database</ulink>. You will need to register before you can submit
+ any bugs this way â and do not forget to read <ulink type="http"
+ url="http://bugzilla.gnome.org/bugwritinghelp.html">Bug Writing
+ Guidelines</ulink>. </para>
+
+ <para> GNOME Library bugs are filed under the <guilabel>website</guilabel>
+ product, in the <guilabel>library.gnome.org</guilabel> component. The
+ following link will get you straight a form prefilled with appropriate
+ values: <ulink type="http"
+ url="http://bugzilla.gnome.org/enter_bug.cgi?product=website&component=library.gnome.org">Enter
+ a new bug report</ulink>. </para>
+
+ <section>
+ <title>Requesting for a documentation to be added</title>
+
+ <para>Library.gnome.org has support for both gnome-doc-utils (manuals)
+ and gtk-doc (references) as well as some minimalistic support for
+ straight passing of HTML files through XSL stylesheets. It can also
+ display links to ressources available on other websites.</para>
+
+ <para>Modules that are part of the GNOME JHBuild modulesets, as published
+ by the release team, are automatically added to the library. For other
+ modules you have to file a bug.</para>
+
+ <para>Please note Library.gnome.org only operates on tarballs, there is
+ no support for documents that are only available through a revision
+ control system, so the first thing is to make sure when requesting for a
+ new document to be added is that a tarball is available. It also has
+ some special support for tarballs hosted on download.gnome.org and will
+ automatically pick up new versions.</para>
+ </section>
+
+ </section>
+
+</article>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]