Documentation patch by apple

git-svn-id: svn://vndb.org/vndb@43 1fe2e327-d9db-4752-bcf7-ef0cb4a1748b

1 files changed, 26 insertions, 12 deletions

diff --git a/data/docs/5 b/data/docs/5
index cea0817f..1778bd3a 100644
--- a/data/docs/5
+++ b/data/docs/5
@@ -30,25 +30,39 @@
 </p>
 
 
-:SUB:Name order
+:SUB:Name Order
 <p>
- In most English speaking countries, names are given in a "given name, family name"
- order. This is called "Western Order". In English, you call someone using their
- given name if you know them well, otherwise use their title and family name.
- In Japanese (and some other languages too), names are given in "family name, given name"
- order. We call this "Japanese Order". In Japanese you can call someone using either
- name with an appropriate suffix. To aid English speakers familiar, some resources
- (e.g. wikipedia) switch round Japanese names. Here on vndb.org, we prefer to use the
- order that the original game used. That is, if it was originally a Japanese game with
- Japanese character names, use Japanese order. If the game is originally English, or
- a character has a completely foreign name (Mary Smith), use Western order.
+ In most English speaking countries, names are given in a "given name, family name" order.
+ This is called "Western Order".
+ In English, you call someone using their given name if you know them well, otherwise use their title and family name.
+ <br />
+ In Japanese (and some other languages too), names are given in "family name, given name" order.
+ We call this "Japanese Order".
+ In Japanese you can call someone using either name with an appropriate suffix.
+ <br />
+ To aid English speakers, some resources (e.g. wikipedia) use Japanese names in Western order.
+ Here on vndb.org, we prefer to use the order that the original game used.
+ <br />
+ That is, if it was originally a Japanese game with Japanese character names, use Japanese order.
+ <br />
+ If the game is originally English, or a character has a completely foreign name (Mary Smith), use Western order.
 </p> 
 
+:SUB:Edit Summaries
+<p>
+ Every edit to any page has an optional "Edit summary" box.
+ <br />
+ This allows you to explain yourself on what your edit is about without cluttering the main page.
+ <br />
+ You can say why you've modified the categories, changed a link, or show where you obtained some information (so that other contributors can verify it).
+ <br />
+ Perhaps you want to add a visual novel to the database but are unable to find more information for it.
+ If you say so here, another contributor is bound to finish it off.
+</p>
 
 :SUB:TODO
 <p>
 Misc documentation:<br />
-- Edit summary<br />
 - Quoting sources in descriptions<br />
 </p>