diff --git a/README.md b/README.md
index bbd96aca..8493b402 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# dotSCAD 3.2 RC
+# dotSCAD 3.2
 
 > **Reduce the burden of mathematics/algorithm when playing OpenSCAD.**
 
diff --git a/RELEASE.md b/RELEASE.md
index ef2aa15d..6a8b360c 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -1,5 +1,56 @@
 > Version numbers are based on [Semantic Versioning](https://semver.org/).
 
+# v3.2
+
+## Deprecated:
+
+ Name | Description
+--|--
+**paths2sections** | use **rails2sections** instead.
+**hull_polyline2d**, **hull_polyline3d** | use **polyline_join** instead.
+**shape_starburst**, **shape_pentagram** | use **shape_star** instead.
+**starburst** | use **polyhedra/star** instead.
+
+## New parameters:
+
+- `angle_between` adds `ccw`.
+
+## New modules/functions:
+
+### Matrix
+
+## 2D/3D Function
+
+ Signature | Description
+--|--
+[**rails2sections**(rails)](https://openhome.cc/eGossip/OpenSCAD/lib3x-rails2sections.html) | create sections along rails.
+
+## Transformation
+
+ Signature | Description
+--|--
+[**select**(i)](https://openhome.cc/eGossip/OpenSCAD/lib3x-select.html) | select module objects.
+[**polyline_join**(points)](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyline_join.html) | place a join on each point. Hull each pair of joins and union all convex hulls.
+
+## 2D Shape
+
+ Signature | Description
+--|--
+[**shape_star**([outer_radius, inner_radius, n])](https://openhome.cc/eGossip/OpenSCAD/lib3x-shape_star.html) | create a 2D star.
+
+## Polyhedra
+
+ Signature | Description
+--|--
+[**polyhedra/star**([outerRadius, innerRadius, height, n])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_star.html) | create a 3D star.
+[**polyhedra/polar_zonohedra**(n[, theta])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_polar_zonohedra.html) | create a [polar zonohedra](https://mathworld.wolfram.com/PolarZonohedron.html).
+[**polyhedra/tetrahedron**(radius[, detail])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_tetrahedron.html) | create a tetrahedron.
+[**polyhedra/hexahedron**(radius[, detail])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_hexahedron.html) | create a hexahedron.
+[**polyhedra/octahedron**(radius[, detail])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_octahedron.html) | create a octahedron.
+[**polyhedra/dodecahedron**(radius[, detail])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_dodecahedron.html) | create a dodecahedron.
+[**polyhedra/icosahedron**(radius[, detail])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_icosahedron.html) | create a icosahedron.
+[**polyhedra/superellipsoid**(radius[, detail])](https://openhome.cc/eGossip/OpenSCAD/lib3x-polyhedra_superellipsoid.html) | create a superellipsoid.
+
 # v3.1
 
 ## Deprecated: