changelog: document further make-release changes

[otter.git] / README.md

diff --git a/README.md b/README.md
index e7fe5c47deecb2fe775d1f0936e6c8d2756b613e..ab91c00f2c6286298983daceb9a71f3e8a3c2fb7 100644 (file)
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ does it need to know) the rules of the game you are playing.  Instead,
 it lets you and your friends play with common tabletop/boardgame
 elements such as hands of cards, boards, and so on.
 
-So it's something like a "tabletop simulater" (but it does not have
+So it's something like a "tabletop simulator" (but it does not have
 any 3D, or a physics engine, or anything like that).
 
 This means that with Otter:
@@ -17,10 +17,10 @@ This means that with Otter:
  * Supporting a new game, that Otter doesn't know about yet, would
    usually not involve writing or modifying any computer programs.
 
- * If Otter already has the necessarily game elements (cards, say) all
+ * If Otter already has the necessary game elements (cards, say) all
    you need to do is write a spec file saying what should be on the
    table at the start of the game.  For example, most Whist variants
-   that start with a standard pack of 52 cards are already playble.
+   that start with a standard pack of 52 cards are already playable.
 
  * You can play games where the rules change as the game goes along,
    or are made up by the players, or are too complicated to write as a
@@ -47,7 +47,7 @@ You will need to be able to talk to your friends about the game, while
 you play.  Otter works well when used together with a voice chat - we
 have had success with Jitsi in voice-only mode.
 
-Most relatively modern desktop browsers should to work with Otter.
+Most relatively modern desktop browsers should be able to work with Otter.
 (The most advanced feature needed is support for WebAssembly.)
 
 
@@ -92,12 +92,6 @@ systems could be made to work, but don't work well right now.
 Otter does not currently have even a built-in text chat facility.  It
 does have a way to share a URL for a voice chat.
 
-Right now Otter is in a beta state.  There are significant
-as-yet-unimplemented improvements that would make it work better for
-more people and more games.  I don't currently promise savefile
-compatibility, or upgradeability, from one Otter version to the next.
-And there are still bugs.
-
 
 Free software, and user freedom
 -------------------------------
@@ -109,11 +103,20 @@ tyranny of programmers `:-)`.
 I would love contributions, particularly to address the limitations I
 mention above, and to improve the user experience.
 
-I am also working to make it possible to let you define your own games
-(including your own pieces, cards, boards, and so on) without having
-to install them on the server.
+I am also working to make it possible to let users define their own
+games (including their own pieces, cards, boards, and so on) without
+having to install them on the server.
 
 The Otter software project is hosted on Debian's GitLab, at
-  https://salsa.debian.org/iwj/otter
+<https://salsa.debian.org/iwj/otter>.
+
 Merge requests (accompanied by a `Signed-off-by` indicating sign-off
 of the Developer Certificate of Origin) would be very welcome.
+
+
+References
+----------
+
+ * [Source repository on Salsa, Debian's GitLab](https://salsa.debian.org/iwj/otter)
+ * [This documentation, online copy](https://www.chiark.greenend.org.uk/~ianmdlvl/otter/docs/)
+ * Mailing lists for [annoucements](https://www.chiark.greenend.org.uk/mailman/listinfo/sgo-software-announce) and [discussion](https://www.chiark.greenend.org.uk/mailman/listinfo/sgo-software-discuss)