X-Git-Url: https://jxself.org/git/?p=open-adventure.git;a=blobdiff_plain;f=README.adoc;h=dca92f3074f63299f9c5432161ebc303c6e27e61;hp=3426278d2dbed0704b0ab9ba90ef20834bcb2752;hb=39fbd7a56fc491a85e8f62348b2da8390198bef0;hpb=3f5970893328894910e3d023b42acec975831f63

diff --git a/README.adoc b/README.adoc
index 3426278..dca92f3 100644
--- a/README.adoc
+++ b/README.adoc
@@ -5,8 +5,9 @@ This code is a forward-port of the Crowther/Woods Adventure 2.5 from
 development written by the original authors.  The authors have given
 permission and encouragement for this release.
 
-The file history.txt contains a more detailed history of this game
-and its ancestors.
+The file history.adoc contains a more detailed history of this game
+and its ancestors.  The file notes.adoc is the maintainer's notes,
+describing project goals and recent changes.
 
 This project is called "Open Adventure" because it's not at all clear
 how to number Adventure past 2.5 without misleading or causing
@@ -15,5 +16,17 @@ original 6-character name on the PDP-10 has been reverted to for the
 executable in order to avoid a collision with the BSD games port of
 the ancestral 1977 version.
 
-You can run a regression test on the code with 'make check'.
+Please see INSTALL.adoc for build info.
+
+Extreme care has been taken to not silently change gameplay. By
+policy, all user-visible changes from 2.5 are revertible with the
+-o (oldstyle) option.
+
+If you encounter a bug (not likely; this code is old and well tested)
+please try to make a test log that reproduces it, using the -l option,
+and ship it to the maintainers.
+
+// end
+
+