docs: refine comments for docs

- Refine comments for the API document.

Author: kikuomax

src/index.ts

@@ -1,7 +1,9 @@
 /**
- * Utility for
+ * Collision box utility for
  * {@link https://docs.mapbox.com/mapbox-gl-js/guides/|Mapbox GL JS}.
  *
+ * @packageDocumentation
+ *
  * @beta
  */
 
@@ -30,12 +32,17 @@ const PLACEMENT_TIMEOUT_IN_MS = 5000;
  *
  * @param map -
  *
- *   Mapbox map instance.
+ *   {@link https://docs.mapbox.com/mapbox-gl-js/api/map/|Mapbox map} instance.
  *
  * @param layerId -
  *
  *   ID of the layer where collision boxes are to be collected.
  *
+ * @returns
+ *
+ *   Collision boxes and features on the layer associated with `layerId` on
+ *   `map`.
+ *
  * @throws RangeError
  *
  *   If there is no layer associated with `layerId`, or if the layer associated

src/types.ts

@@ -24,7 +24,14 @@ export interface Box {
 export interface FeatureBox {
   /** Box of the feature. */
   box: Box;
-  /** Feature. */
+  /**
+   * Feature.
+   *
+   * @remarks
+   *
+   * Contains similar information you can get with
+   * {@link https://docs.mapbox.com/mapbox-gl-js/api/map/#map#queryrenderedfeatures|Map#queryRenderedFeatures}.
+   */
   feature: QueryFeature;
 }
 
@@ -33,7 +40,8 @@ export interface FeatureBox {
  *
  * @remarks
  *
- * `QueryFeature` is defined in https://github.com/mapbox/mapbox-gl-js/blob/e29e113ff5e1f4c073f84b8cbe546006d2fb604f/src/util/vectortile_to_geojson.js#L6-L9
+ * `QueryFeature` is defined in
+ * {@link https://github.com/mapbox/mapbox-gl-js/blob/e29e113ff5e1f4c073f84b8cbe546006d2fb604f/src/util/vectortile_to_geojson.js#L6-L9}
  *
  * `QueryFeature` is exported as `MapboxGeoJSONFeature` from `@types/mapbox-gl`.
  *