From efd9677cea702541ea3cf3b378e9ec00acbdc13c Mon Sep 17 00:00:00 2001
From: Ben Boeckel <MathStuf@gmail.com>
Date: Mon, 3 Aug 2009 21:38:08 -0400
Subject: Add initial chapter on editing

---
 sigmodr/doc/editing-beginning.docbook | 26 ++++++++++++++++++++++++++
 sigmodr/doc/index.docbook             |  2 ++
 2 files changed, 28 insertions(+)
 create mode 100644 sigmodr/doc/editing-beginning.docbook

diff --git a/sigmodr/doc/editing-beginning.docbook b/sigmodr/doc/editing-beginning.docbook
new file mode 100644
index 00000000..9528b035
--- /dev/null
+++ b/sigmodr/doc/editing-beginning.docbook
@@ -0,0 +1,26 @@
+<chapter id="editing-beginning">
+ <chapterinfo>
+  <authorgroup>
+   <author>
+    &Ben.Boeckel;
+    &Ben.Boeckel.mail;
+   </author>
+   <!-- TRANS:ROLES_OF_TRANSLATORS -->
+  </authorgroup>
+  <date>2009-08-03</date>
+ </chapterinfo>
+ <title>Beginning editing</title>
+ 
+ <note>
+  <title>On internal references</title>
+  <para>When editing, keep in mind that internal references are kept according
+  to internal ID numbers and that ID numbers are assigned to new objects as the
+  lowest available number. ID numbers are unique within each group of children
+  of a specific object. When adding and deleting objects, references may be
+  changed from what was originally intended. Using the
+  <link linkend="validation">validator</link> after each deletion can help to
+  reduce errors made from such automatic assignments.</para>
+ </note>
+ 
+ <para></para>
+</chapter>
diff --git a/sigmodr/doc/index.docbook b/sigmodr/doc/index.docbook
index f910ac89..0df34ac3 100644
--- a/sigmodr/doc/index.docbook
+++ b/sigmodr/doc/index.docbook
@@ -11,6 +11,7 @@
  <!ENTITY sigmodr-introduction SYSTEM "introduction.docbook" >
  <!ENTITY sigmodr-basics SYSTEM "basics.docbook" >
  <!ENTITY sigmodr-validation SYSTEM "validation.docbook" >
+ <!ENTITY sigmodr-editing-beginning SYSTEM "editing-beginning.docbook" >
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
  <!ENTITY % addindex "IGNORE" >
 ]>
@@ -45,6 +46,7 @@
  &sigmodr-introduction;
  &sigmodr-basics;
  &sigmodr-validation;
+ &sigmodr-editing-beginning;
  <appendix id="information">
   <title>Information</title>
   <para>&sigmodr; is a part of &sigen;</para>
-- 
cgit