docs: Add EdgeSplitModifier docs (#1002)

Author: Methuselah96

types/three/examples/jsm/modifiers/EdgeSplitModifier.d.ts

@@ -1,19 +1,26 @@
 import { BufferGeometry } from "three";
 
+/**
+ * {@link EdgeSplitModifier} is intended to modify the geometry "dissolving" the edges to give a smoother look.
+ *
+ * @example
+ * const geometry = new THREE.IcosahedronGeometry( 10, 3 );
+ * const modifier = new EdgeSplitModifier();
+ * const cutOffAngle = 0.5;
+ * const tryKeepNormals = false;
+ *
+ * modifier.modify( geometry, cutOffAngle, tryKeepNormals );
+ */
 export class EdgeSplitModifier {
+    /**
+     * Create a new {@link EdgeSplitModifier} object.
+     */
     constructor();
 
     /**
-     * @param geometry					The geometry to modify by splitting edges.
-     * 									This geometry can be any of any type: Geometry or BufferGeometry, indexed or
-     * 									not...
-     *
-     * @param cutOffPoint				The cutoff angle in radians. If the angle between two face normals is higher
-     * 									than this value, a split will be made.
-     *
-     * @param [tryKeepNormals = true]	Set to true to keep the normal values for vertices that won't be split.
-     * 									To use this feature, you also need to pass an indexed geometry with a 'normal'
-     * 									BufferAttribute.
+     * Using interpolated vertex normals, the mesh faces will blur at the edges and appear smooth.
+     * You can control the smoothness by setting the `cutOffAngle`.
+     * To try to keep the original normals, set `tryKeepNormals` to `true`.
      */
     modify(geometry: BufferGeometry, cutOffPoint: number, tryKeepNormals: boolean): BufferGeometry;
 }