Prepare changelog and tweak engine docs

Author: niklasf

CHANGELOG.rst

@@ -1,6 +1,30 @@
 Changelog for python-chess
 ==========================
 
+Upcoming in the next release
+----------------------------
+
+Changes:
+
+* `chess.variant.GiveawayBoard` **now starts with castling rights**.
+  `chess.variant.AntichessBoard` is the same variant without castling rights.
+* UCI info parser no longer reports errors when encountering unknown tokens.
+* Performance improvements for repetition detection.
+* Since Python 3.8: `chess.syzygy`/`chess.polyglot` use `madvise(MADV_RANDOM)`
+  to prepare table/book files for random access.
+
+Bugfixes:
+
+* Fix syntax error in type annotation of `chess.engine.run_in_background()`.
+* Fix castling rights when king is exploded in Atomic. Mitigated by the fact
+  that the game is over and that it did not affect FEN.
+* Fix insufficient material with underpromoted pieces in Crazyhouse. Mitigated
+  by the fact that affected positions are unreachable in Crazyhouse.
+
+Features:
+
+* Support `wdl` in UCI info (usually activated with `UCI_ShowWDL`).
+
 New in v0.28.3
 --------------
 

docs/engine.rst

@@ -6,7 +6,8 @@ implements an abstraction for playing moves and analysing positions with
 both kinds of engines.
 
 The preferred way to use the API is with an
-`asyncio <https://docs.python.org/3/library/asyncio.html>`_ event loop.
+`asyncio <https://docs.python.org/3/library/asyncio.html>`_ event loop
+(examples show usage with Python 3.7 or later).
 The examples also show a synchronous wrapper
 :class:`~chess.engine.SimpleEngine` that automatically spawns an event loop
 in the background.
@@ -111,8 +112,8 @@ Example: Let Stockfish play against itself, 100 milliseconds per move.
         ``depth``, ``seldepth``, ``time`` (in seconds), ``nodes``, ``nps``,
         ``tbhits``, ``multipv``.
 
-        Others: ``currmove``, ``currmovenumber``, ``hashfull``,
-        ``cpuload``, ``refutation``, ``currline``, ``ebf`` and ``string``.
+        Others: ``currmove``, ``currmovenumber``, ``hashfull``, ``cpuload``,
+        ``refutation``, ``currline``, ``ebf``, ``wdl``, and ``string``.
 
     .. py:attribute:: draw_offered