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

diff --git a/README.adoc b/README.adoc
index b513dc4..dca92f3 100644
--- a/README.adoc
+++ b/README.adoc
@@ -6,7 +6,8 @@ development written by the original authors.  The authors have given
 permission and encouragement for this release.
 
 The file history.adoc contains a more detailed history of this game
-and its ancestors.
+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
+
+