diff --git a/doc/hooks/index.md b/doc/hooks/index.md
index 42a6553344b2..050345c98a55 100644
--- a/doc/hooks/index.md
+++ b/doc/hooks/index.md
@@ -25,6 +25,7 @@ patch-rc-path-hooks.section.md
 perl.section.md
 pkg-config.section.md
 postgresql-test-hook.section.md
+premake.section.md
 python.section.md
 scons.section.md
 tetex-tex-live.section.md
diff --git a/doc/hooks/premake.section.md b/doc/hooks/premake.section.md
new file mode 100644
index 000000000000..b2c2d8fb637c
--- /dev/null
+++ b/doc/hooks/premake.section.md
@@ -0,0 +1,7 @@
+# Premake {#premake-hook}
+
+This setup hook attempts to configure the package using [the Premake build configuration system](https://premake.github.io/). It overrides the `configurePhase` by default, if none exists.
+
+[]{#premake-hook-premakefile} The Premakefile to use can be specified by setting `premakefile` in the derivation.
+
+[]{#premake-hook-premakeFlagsArray} The flags passed to Premake can be configured by adding strings to the `premakeFlags` list.