diff --git a/orx-mesh-generators/README.md b/orx-mesh-generators/README.md
index 17f9e0a7..1b5ed903 100644
--- a/orx-mesh-generators/README.md
+++ b/orx-mesh-generators/README.md
@@ -88,7 +88,7 @@ Check out the [source code](src/commonMain/kotlin) to learn about function argum
### decal/DemoDecal01
Demonstrate decal generator as an object slicer
-@see
+

@@ -97,7 +97,7 @@ Demonstrate decal generator as an object slicer
### decal/DemoDecal02
Demonstrate decal generation and rendering
-@see
+

diff --git a/orx-noise/README.md b/orx-noise/README.md
index 2f65079a..861f7405 100644
--- a/orx-noise/README.md
+++ b/orx-noise/README.md
@@ -238,7 +238,7 @@ val v8 = billow(seed, x, y, z, ::perlinLinear, octaves, lacunarity, gain)
### DemoTriangleNoise01
Demonstrate the generation of uniformly distributed points inside a list of triangles
-@see
+

diff --git a/orx-shapes/README.md b/orx-shapes/README.md
index eb4e10de..3d5ff74a 100644
--- a/orx-shapes/README.md
+++ b/orx-shapes/README.md
@@ -6,7 +6,12 @@ Collection of 2D shape generators and modifiers.
## Demos
### adjust/DemoAdjustContour01
+Demonstrates how to use `adjustContour` to select and modify three vertices
+in a circular contour. In OPENRNDR circles contain 4 cubic bézier
+segments connecting 4 vertices.
+On every animation frame the circular contour is created and transformed
+using sines, cosines and the variable `seconds` for an animated effect.

@@ -14,7 +19,8 @@ Collection of 2D shape generators and modifiers.
### adjust/DemoAdjustContour02
-
+Demonstrates how to use `adjustContour` to select and remove vertex 0
+from a circular contour, then select and animate the position and scale the new vertex 0.

@@ -22,6 +28,15 @@ Collection of 2D shape generators and modifiers.
### adjust/DemoAdjustContour03
+Demonstrates how to select and alter the edges of a rectangle.
+
+The rectangle is a scaled-down version window bounds.
+
+By default, the edges of a rectangular contour are linear, so the `edge.toCubic()` method
+is called to make it possible to bend them.
+
+Then various edges are selected one by one and transformed over time using operations like
+scale, rotate, splitAt and moveBy.

@@ -30,6 +45,12 @@ Collection of 2D shape generators and modifiers.
### adjust/DemoAdjustContour04
+Demonstrates an `adjustContour` animated effect where edge 0 of a contour
+is replaced by a point sampled on that edge. The specific edge point oscillates between
+0.0 (at the start) and 1.0 (at the end) using a cosine and the `seconds` variable.
+
+The base contour used for the effect alternates every second
+between a rectangular and a circular contour.

@@ -420,7 +441,7 @@ and a dynamic anchor point derived from the cosine of elapsed time.
### primitives/DemoRectangleIntersection01
Demonstrate rectangle-rectangle intersection
-@see
+
