Progress Bar, Table HTML, Tag, Tree polish

packages/core/src/components/progress-bar/progress-bar.md

@@ -3,15 +3,15 @@
 Progress bars indicate progress towards the completion of a task or an
 indeterminate loading state.
 
+@reactExample ProgressExample
+
+@## Props
+
 `ProgressBar` is a simple stateless component that renders the appropriate HTML
 markup. It supports a `value` prop between 0 and 1 that determines the width of
 the progress meter. Omitting `value` will result in an "indeterminate" progress
 meter that fills the entire bar.
 
-@reactExample ProgressExample
-
-@## Props
-
 @interface IProgressBarProps
 
 @## CSS

packages/core/src/components/table/table-html.md

@@ -1,6 +1,6 @@
 @# Tables (HTML)
 
-This component adds Blueprint styling to native HTML tables.
+This component provides Blueprint styling to native HTML tables.
 
 <div class="@ns-callout @ns-intent-primary @ns-icon-info-sign">
     <h4 class="@ns-heading">This is not @blueprintjs/table</h4>

packages/core/src/components/tag/tag.md

@@ -6,21 +6,15 @@ Tags are great for lists of strings.
 
 @## Props
 
-The `Tag` component is available in the __@blueprintjs/core__ package.
-Make sure to review the [getting started docs for installation info](#blueprint/getting-started).
-
-Tag components render `.@ns-tag` elements with optional close buttons. Provide tag content as `children`.
-
-You can provide your own props to these components as if they were regular JSX HTML elements. If
-you provide a `className` prop, the class names you provide will be added alongside of the default
-Blueprint class name.
+`Tag` is a stateless wrapper around its children with support for an optional
+close button. It also supports all HTML `<span>` props.
 
 @interface ITagProps
 
 @## CSS
 
-An optional "remove" button can be added inside a tag with a
-`button.@ns-tag-remove` as the last child. The button is a separate element to
-support interaction handlers in your framework of choice.
+Create a tag with a `span.@ns-tag`. An optional "remove" button can be added
+with a `button.@ns-tag-remove` as the last child. The button is a separate
+element to support interaction handlers in your framework of choice.
 
 @css tag

packages/core/src/components/tag/tag.tsx

@@ -13,7 +13,7 @@ import { Text } from "../text/text";
 
 export interface ITagProps extends IProps, IIntentProps, React.HTMLAttributes<HTMLSpanElement> {
     /**
-     * If set to `true`, the tag will display in an active state.
+     * Whether the tag should appear in an active state.
      * @default false
      */
     active?: boolean;
@@ -60,7 +60,7 @@ export interface ITagProps extends IProps, IIntentProps, React.HTMLAttributes<HT
 
     /**
      * Click handler for remove button.
-     * Button will only be rendered if this prop is defined.
+     * The remove button will only be rendered if this prop is defined.
      */
     onRemove?: (e: React.MouseEvent<HTMLButtonElement>, tagProps: ITagProps) => void;
 

packages/core/src/components/tree/tree.md

@@ -7,7 +7,7 @@ Trees display hierarchical data.
 @## Props
 
 `Tree` is a stateless component. Its contents are dictated by the `contents` prop, which is an array
-of `ITreeNode`s (see [below](#components/tree.tree-node-interface)). The tree is multi-rooted if
+of `ITreeNode`s (see [below](#components/tree.tree-node)). The tree is multi-rooted if
 `contents` contains more than one top-level object.
 
 A variety of interaction callbacks are also exposed as props. All interaction callbacks supply a
@@ -18,9 +18,7 @@ example, `[2, 0]` represents the first child (`0`) of the third top-level node (
 
 @### Instance methods
 
-<div class="@ns-monospace-text">Tree</div>
-
-* `getNodeContentElement(nodeId: string | number): HTMLElement | undefined` &ndash;
+* `Tree.getNodeContentElement(nodeId: string | number): HTMLElement | undefined` &ndash;
   Returns the underlying HTML element of the `Tree` node with an id of `nodeId`.
   This element does not contain the children of the node, only its label and controls.
   If the node is not currently mounted, `undefined` is returned.