diff --git a/src/Scaffolding/Scaffolding.php b/src/Scaffolding/Scaffolding.php
index 1d44e4c4876cb7071600082da467922acc01b33e..53855b3326c8b42e49e1bef66750c6bbd7f8ab46 100644
--- a/src/Scaffolding/Scaffolding.php
+++ b/src/Scaffolding/Scaffolding.php
@@ -23,6 +23,10 @@ final class Scaffolding
 
 
 	/**
+	 * Usage:
+	 * ```php
+	 * return Scaffolding::definitionsForPgTable(...);
+	 * ```
 	 * @return ClassDefinition[]
 	 */
 	public static function definitionsForPgTable(
@@ -49,6 +53,14 @@ final class Scaffolding
 	}
 
 
+	/**
+	 * Usage:
+	 * ```php
+	 * $builders = Scaffolding::buildersForPgTable(...);
+	 * $builders->row()->decorate(...);
+	 * return $builders->buildAll();
+	 * ```
+	 */
 	public static function buildersForPgTable(
 		PostgresReflector $pgReflector,
 		TypeMapper $mapper,