diff --git a/packages/dataverse/src/pointer.ts b/packages/dataverse/src/pointer.ts
index aab663f..243efbc 100644
--- a/packages/dataverse/src/pointer.ts
+++ b/packages/dataverse/src/pointer.ts
@@ -137,8 +137,6 @@ export const getPointerParts = (
  * ```
  *
  * @param args - The pointer parameters.
- * @param args.root - The {@link Atom} the pointer applies to.
- * @param args.path - The path to the (nested) property the pointer points to.
  *
  * @typeParam O - The type of the value being pointed to.
  */
diff --git a/packages/dataverse/src/utils/Emitter.ts b/packages/dataverse/src/utils/Emitter.ts
index 289136b..01da16c 100644
--- a/packages/dataverse/src/utils/Emitter.ts
+++ b/packages/dataverse/src/utils/Emitter.ts
@@ -64,18 +64,15 @@ export default class Emitter<V> {
     return this._tappers.size !== 0
   }
 
-  /**
-   * Handler to execute when the number of tappers (subscribers) changes.
-   *
-   * @callback Emitter~numberOfTappersChangeHandler
-   *
-   * @param {number} n - The current number of  tappers (subscribers).
-   */
-
   /**
    * Calls callback when the number of tappers (subscribers) changes.
    *
-   * @param {Emitter~requestCallback} cb - The function to be called.
+   * @example
+   * ```ts
+   * emitter.onNumberOfTappersChange((n) => {
+   *   console.log("number of tappers changed:", n)
+   * })
+   * ```
    */
   onNumberOfTappersChange(cb: (n: number) => void) {
     this._onNumberOfTappersChangeListener = cb
diff --git a/theatre/core/src/sheetObjects/SheetObjectTemplate.test.ts b/theatre/core/src/sheetObjects/SheetObjectTemplate.test.ts
index 0ca779f..550b2ed 100644
--- a/theatre/core/src/sheetObjects/SheetObjectTemplate.test.ts
+++ b/theatre/core/src/sheetObjects/SheetObjectTemplate.test.ts
@@ -1,5 +1,4 @@
-/**
- // eslint-disable-next-line tsdoc/syntax
+/*
  * @jest-environment jsdom
  */
 import {setupTestSheet} from '@theatre/shared/testUtils'