Index: openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml,v
diff -u -r1.2 -r1.3
--- openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml	20 Aug 2003 16:20:19 -0000	1.2
+++ openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml	11 Dec 2003 21:39:50 -0000	1.3
@@ -8,12 +8,12 @@
   <title>OpenACS Internationalization Requirements</title>
 
   <authorblurb>
-      by Henry Minsky, 
+      <para>by Henry Minsky, 
        <ulink url="mailto:yon@openforce.net">Yon Feldman</ulink>, 
        <ulink url="mailto:lars@collaboraid.biz">Lars Pind</ulink>,
        <ulink url="mailto:peter@collaboraid.biz">Peter Marklund</ulink>, 
        <ulink url="mailto:christian@collaboraid.biz">Christian Hvid</ulink>,
-       and others.
+       and others.</para>
   </authorblurb>
 
   <sect2 id="i18n-requirements-introduction">
@@ -118,8 +118,12 @@
 cleanly back into the code base, it would require making a new fork
 of the source code for each locale.</para>
 
-</sect2><sect2 id="III._System/Application_Overview"><title>System/Application Overview</title>
+</sect2>
 
+<sect2 id="system-application-overview">
+
+<title>System/Application Overview</title>
+
 <para>A globalized application will perform some or all of the
 following steps to handle a page request for a specific
 locale:</para>
@@ -214,8 +218,8 @@
 
 <listitem>
 <para>A developer needs to author a web site which operates in
-multiple languages simultaneously. For example, arsDigita.com with
-content and navigation in English, German, and Japanese.</para>
+multiple languages simultaneously. For example, www.un.org with
+content and navigation in multiple languages.</para>
 
 <para>The site would have an end-user visible UI to support these
 languages, and the content management system must allow articles to
@@ -313,7 +317,7 @@
 
 <blockquote>
 <para>See
-<ulink url="http://acs40.arsdigita.com/doc/acs-content-repository/requirements.html">Content
+<ulink url="/doc/acs-content-repository/requirements.html#100-20">Content
 Repository Requirement 100.20</ulink></para>
 
 <para><emphasis>10.10</emphasis> Provide a consistent
@@ -369,8 +373,10 @@
 </itemizedlist>
 </blockquote>
 
-</sect2><sect2 id="VI.C_Resource_Bundles_/_Content_Repository"><title>Resource Bundles / Content Repository</title>
+</sect2><sect2 id="resource-bundles">
 
+<title>Resource Bundles / Content Repository</title>
+
 <para><emphasis>30.0</emphasis></para>
 <para>A mechanism must be provided for a developer to group a set
 of arbitrary content resources together, keyed by a unique
@@ -380,7 +386,7 @@
 localizable nav-bar mechanism for a site? A navigation bar might be
 made up of a set of text strings and graphics, where the graphics
 themselves are locale-specific, such as images of English or
-Japanese text (as on www.arsdigita.com). It should be easy to
+Japanese text (as on www.un.org). It should be easy to
 specify alternate configurations of text and graphics to lay out
 the page for different locales.</para>
 
@@ -677,7 +683,7 @@
 column size declarations in the schema are large enough to
 accomodate required data (such as email addresses in
 Japanese).  <remark>Since 5.0.0, this is covered in the database
-install instructions for both PostGreSQL and Oracle.</remark></para>
+install instructions for both PostgreSQL and Oracle.</remark></para>
 </blockquote>
 
 </sect2><sect2 id="VI.I_Email_and_Messaging"><title>Email and