diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 4d427da3..a490463d 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -314,8 +314,10 @@ const generic_params = [
    * @param {number | Pattern} amount between 0 and 1, where 1 is the length of the sample
    * @synonyms loopb
    * @example
-   * s("numbers").loopBegin("<0 .25 .5 .75>").loop(1)
-   *
+   * s("numbers")
+   *  .loop(1)
+   *  .begin(0).end(1)
+   *  .loopBegin("<0 .25 .5 .75>")
    */
   ['loopBegin', 'loopb'],
   /**
@@ -323,8 +325,11 @@ const generic_params = [
    * @param {number | Pattern} amount between 0 and 1, where 1 is the length of the sample
    * @synonyms loope
    * @example
-   * s("numbers").loopEnd("<0 .25 .5 .75>").loop(1)
-   *
+   * s("numbers")
+   *  .loop(1)
+   *  .begin(0).end(1)
+   *  .loopBegin("<0 .25 .5 .75>")
+   *  .loopEnd("<0.1 .35 .6 .85>")
    */
   ['loopEnd', 'loope'],
   /**
diff --git a/website/src/pages/learn/samples.mdx b/website/src/pages/learn/samples.mdx
index 9f79e54a..b1ef1cd3 100644
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@@ -303,6 +303,18 @@ Sampler effects are functions that can be used to change the behaviour of sample
 
 <JsDoc client:idle name="Pattern.end" h={0} />
 
+### loop
+
+<JsDoc client:idle name="loop" h={0} />
+
+### loopBegin
+
+<JsDoc client:idle name="loopBegin" h={0} />
+
+### loopEnd
+
+<JsDoc client:idle name="loopEnd" h={0} />
+
 ### cut
 
 <JsDoc client:idle name="cut" h={0} />