chore(auto-place): improve JSDoc

lib/features/auto-place/AutoPlaceUtil.js

@@ -92,10 +92,14 @@ export function generateGetNextPosition(nextPositionDirection) {
 }
 
 /**
- * Return target at given position, if defined.
+ * Return connected element at given position and within given bounds. Takes
+ * connected elements from host and attachers into account, too.
  *
- * This takes connected elements from host and attachers
- * into account, too.
+ * @param {Shape} source
+ * @param {Point} position
+ * @param {Shape} element
+ *
+ * @return {Shape|undefined}
  */
 export function getConnectedAtPosition(source, position, element) {
 
@@ -255,13 +259,13 @@ export function getConnectedDistance(source, hints) {
 }
 
 /**
- * Returns all connected elements around the given source.
+ * Returns all elements connected to given source.
  *
  * This includes:
  *
- *   - connected elements
- *   - host connected elements
- *   - attachers connected elements
+ *   - elements connected to source
+ *   - elements connected to host if source is an attacher
+ *   - elements connected to attachers if source is a host
  *
  * @param {Shape} source
  *
@@ -284,6 +288,13 @@ function getAutoPlaceClosure(source) {
   return allConnected;
 }
 
+/**
+ * Get all connected elements.
+ *
+ * @param {Shape} element
+ *
+ * @returns {Shape[]}
+ */
 function getConnected(element) {
   return getTargets(element).concat(getSources(element));
 }