diff --git a/doc/generic/pgf/ChangeLog b/doc/generic/pgf/ChangeLog
index e34428fce..2e12f9a86 100644
--- a/doc/generic/pgf/ChangeLog
+++ b/doc/generic/pgf/ChangeLog
@@ -1,3 +1,115 @@
+2020-12-25 Henri Menke
+
+    - Release 3.1.8
+
+2020-12-03 Henri Menke
+
+    - CI: Use GitHub Actions from pgf-tikz/actions
+
+2020-12-01 Henri Menke
+
+    - Remove empty or outdated files
+
+2020-12-25 Henri Menke
+
+    - Preserve coordinate relativity across ..
+
+2020-12-22 Henri Menke
+
+    - Merge pull request #967 from muzimuzhi/handle-relax
+
+2020-12-22 Henri Menke
+
+    - fixup! doc: Add note on expandsion of path operations #966
+
+2020-12-22 muzimuzhi
+
+    - Remove spurious spaces, terminate \advance in time
+
+2020-12-22 muzimuzhi
+
+    - tikz: handle \relax and frozen \relax on path #966
+
+2020-12-21 Henri Menke
+
+    - doc: Add note on expandsion of path operations #966
+
+2020-12-17 Henri Menke
+
+    - Merge pull request #961 from muzimuzhi/improve-doc
+
+2020-12-18 muzimuzhi
+
+    - doc: relation of /.code & /.initial will remain
+
+2020-12-17 Henri Menke
+
+    - Only force signed releases #962
+
+2020-12-18 muzimuzhi
+
+    - doc: clarify /.code keys don't respect /.initial #654
+
+2020-12-18 muzimuzhi
+
+    - Added doc for \pgfpointtransformed #844
+
+2020-12-17 Henri Menke
+
+    - Merge pull request #959 from muzimuzhi/improve-doc
+
+2020-12-15 muzimuzhi
+
+    - doc: clarify path or full key start with slash #904
+
+2020-12-17 Henri Menke
+
+    - Merge pull request #956 from muzimuzhi/improve-doc
+
+2020-12-15 muzimuzhi
+
+    - pgfmathdeclarerandomlist: improve doc and code comment
+
+2020-12-14 Henri Menke
+
+    - Merge pull request #955 from Ordoviz/master
+
+2020-12-14 Henri Menke
+
+    - pgfmathrandominteger: reordering of arguments incomplete #954
+
+2020-12-12 Henri Menke
+
+    - fpu: mark /pgf/fpu/install only as not experimental
+
+2020-11-30 Lennard Hofmann
+
+    - Fix typos in manual
+
+2020-12-11 Henri Menke
+
+    - Merge branch 'PimpLuaExamples' of https://github.com/Mo-Gul/pgf
+
+2020-12-11 Henri Menke
+
+    - docs: set terminal table -> set table #952
+
+2020-06-21 Stefan Pinnow
+
+    - correct codeexample preamble entries in Lua file
+
+2020-06-21 Stefan Pinnow
+
+    - made some "normal" `codeexample`s compile again (when extracted)
+
+2020-06-21 Stefan Pinnow
+
+    - just added end line commata at the end of values/styles
+
+2020-06-18 Stefan Pinnow
+
+    - added hints which libraries need to be loaded as well to make the example in `pgfmanual-en-tikz-graphs.tex` work closes issue #755)
+
 2020-12-01 Henri Menke
 
     - Release 3.1.7a
diff --git a/doc/generic/pgf/RELEASE_NOTES.md b/doc/generic/pgf/RELEASE_NOTES.md
index 677c2d040..22437f3da 100644
--- a/doc/generic/pgf/RELEASE_NOTES.md
+++ b/doc/generic/pgf/RELEASE_NOTES.md
@@ -1,9 +1,34 @@
+# BREAKING CHANGES
+
+If a topath is bent by any of the in=, out=, bend=, etc. options, a Bezier
+curve is constructed in the background.  To infer the positions of the control
+points the start and end coordinate are converted to absolute coordinates.
+However, this has the effect that subsequent points on the path think that the
+endpoint of the topath was absolute which can lead to counter-intuitive path
+construction, e.g.
+```latex
+\draw (2,0) to[out=0,in=180] +(1,0) -- ++(0,-1) -- +(1,0);
+```
+If old code relies on this behavior, this drawing will silently break!  Please
+open an issue if you rely on this.
+
 # Bug fixes
 
-Another issue with the new LaTeX hook mechanism surfaced in the external
-library which is being worked around now.
+This release introduces a fix for path handling which concerns expansion of
+tokens on the path in particular with respect to conditional.  Previously when
+the expansion of a conditonal resulted in a frozen \relax the parser would just
+give up.  Now the parser will skip over the frozen \relax and continue to
+expand tokens.  Whether this will result in a meaningful expansion is up to the
+user.
 
 This release also includes other bug fixes. On GitHub you can click the commit
 hashes and the issue numbers to get to the fix and the ticket, respectively.
 
-3c46a6974 #947
+a4c275704 #952
+8a997bbc1 #954
+8f37bca84 #962
+3cbe5a192 #844
+49e5f0a08 #654
+17a95e4c5 #966
+ad06895a6 #966
+79e613ae1 #966