[Hopefully] final documentation tweaks

diff --git a/WELCOME.txt b/WELCOME.txt
index f4a663e..99b3904 100644 (file)
--- a/WELCOME.txt
+++ b/WELCOME.txt
@@ -1,3 +1,4 @@
 Welcome! You've found the UCC::ProgComp 2010 kit.
 
-The full documentation is in the "doc" directory. Alternatively, if you want to dive straight into the code, see the "src" directory.
\ No newline at end of file
+The full documentation is in the "doc" directory. Alternatively, if you 
+want to dive straight into the code, see the "src" directory.

diff --git a/doc/UNSUPPORTED.txt b/doc/UNSUPPORTED.txt
index fb73fca..7d665b0 100644 (file)
--- a/doc/UNSUPPORTED.txt
+++ b/doc/UNSUPPORTED.txt
@@ -1,4 +1,4 @@
-UNSUPPORTED.txt: This file describes the wire protocol. You should only need this if you're debugging an external agent, or if you're interested in writing an agent in an unsupported language.
+UNSUPPORTED.txt: This file describes the wire protocol. You should only need this if you're debugging a non-Python agent, or if you're interested in writing an agent in an unsupported language.
 
 If you are interested in using an unsupported language, consult the website for details on how to check with the organiser first.
 

diff --git a/doc/WELCOME.txt b/doc/WELCOME.txt
index ce767c6..465ee34 100644 (file)
--- a/doc/WELCOME.txt
+++ b/doc/WELCOME.txt
@@ -3,14 +3,18 @@ Welcome to UCC::ProgComp 2010!
 This document will acquaint you with the competition: the rules, how to 
 write an agent, and what you need to do to enter.
 
-=== What is UCC::ProgComp? === Good question! The facetious answer is 
-that it's the package whose documentation you are currently reading. The 
-long answer is that it's a project of the University Computer Club 
-(UCC), a student club affiliated with the Guild of Undergraduates at the 
-University of Western Australia. UCC::ProgComp is designed to raise 
-interest in programming and raise awareness of what UCC offers.
-
-=== Why should I enter? === For a number of reasons:
+=== What is UCC::ProgComp? ===
+
+Good question! The facetious answer is that it's the package whose 
+documentation you are currently reading. The long answer is that it's a 
+project of the University Computer Club (UCC), a student club affiliated 
+with the Guild of Undergraduates at the University of Western Australia. 
+UCC::ProgComp is designed to raise interest in programming and raise 
+awareness of what UCC offers.
+
+=== Why should I enter? ===
+
+For a number of reasons:
  - there are prizes.
  - it's a low-risk opportunity to learn how to program or to practise 
 your programming. You don't need to be an expert to enter, and it's a 
@@ -19,6 +23,7 @@ to do.
  - To meet other computer-oriented people around UCC.
 
 === What's the basic premise? ===
+
 Entry to the UCC::ProgComp 2010 is by writing an "agent".
 
 Your agent spends its life in a dystopian RPS underworld, where at any 
@@ -61,6 +66,7 @@ decision about which to target.
 
 
 === How do I win? ===
+
 The object of the game is for the descendants of your agent to be the 
 dominant species.