library-web r454 - in trunk: . data/pages/C

[fpeters svn gnome org]

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&amp;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>