chore: Improve docstrings.

Author: gonfunko

core/comments/collapse_comment_bar_button.ts

@@ -18,7 +18,7 @@ export const COMMENT_COLLAPSE_BAR_BUTTON_FOCUS_IDENTIFIER =
   '_collapse_bar_button';
 
 /**
- * Icon that toggles the collapsed state of a comment.
+ * Button that toggles the collapsed state of a comment.
  */
 export class CollapseCommentBarButton extends CommentBarButton {
   /**

core/comments/comment_bar_button.ts

@@ -59,7 +59,7 @@ export abstract class CommentBarButton implements IFocusableNode {
   abstract performAction(e?: Event): void;
 
   /**
-   * Returns the dimensions of this button in SVG units.
+   * Returns the dimensions of this button in workspace coordinates.
    *
    * @param includeMargin True to include the margin when calculating the size.
    * @returns The size of this button.

core/keyboard_nav/block_navigation_policy.ts

@@ -148,6 +148,7 @@ function getBlockNavigationCandidates(
  * Returns the next/previous stack relative to the given element's stack.
  *
  * @param current The element whose stack will be navigated relative to.
+ * @param workspace The workspace to navigate between stacks on.
  * @param delta The difference in index to navigate; positive values navigate
  *     to the nth next stack, while negative values navigate to the nth previous
  *     stack.