From 1a724f593ef2b60b92f499d26312620406a65cb7 Mon Sep 17 00:00:00 2001
From: Gilad Gray <giladgray@gmail.com>
Date: Fri, 16 Nov 2018 13:40:46 -0500
Subject: [PATCH] docs edits (#3161)

---
 packages/docs-app/src/blueprint.md               |  2 +-
 packages/docs-app/src/whats-new-3.0.md           |  2 +-
 .../src/components/select/select-component.md    | 16 ++++++++++++----
 3 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/packages/docs-app/src/blueprint.md b/packages/docs-app/src/blueprint.md
index b2e3d19ce01..c1158611399 100644
--- a/packages/docs-app/src/blueprint.md
+++ b/packages/docs-app/src/blueprint.md
@@ -7,7 +7,7 @@ It is optimized for building complex data-dense interfaces for desktop applicati
 @reactDocs Welcome
 
 <div class="@ns-callout @ns-intent-success @ns-icon-endorsed">
-    <h4 class="@ns-heading" style="margin: 0">Blueprint 3.0.0 is out now! [See what's new.](#blueprint/whats-new-3.0)</h4>
+    <h4 class="@ns-heading">Blueprint v3 is available now! [See what's new.](#blueprint/whats-new-3.0)</h4>
 </div>
 
 @## Quick start
diff --git a/packages/docs-app/src/whats-new-3.0.md b/packages/docs-app/src/whats-new-3.0.md
index 2435e189198..62c84b4737c 100644
--- a/packages/docs-app/src/whats-new-3.0.md
+++ b/packages/docs-app/src/whats-new-3.0.md
@@ -15,7 +15,7 @@ Blueprint 3.0 supports multiple major versions of Blueprint on the same page thr
     - Affects `<h1>`-`<h6>`, `<blockquote>`, `<code>`, `<pre>`, `<ol>`, `<ul>`, `<hr>`, `<table>`
     - The above elements do not require classes when used inside a container element with `Classes.RUNNING_TEXT`.
 - Allow string literals for enums! `<Button intent="success" />`
-- New `OverflowList` and `MultiSlider` components.
+- Many new components! Look for the <span class="@ns-tag @ns-intent-success @ns-minimal">new</span> tag in the sidebar.
 - Complete refactor of documentation content to focus on React usage and de-emphasize CSS/HTML usage.
 
 <a class="@ns-button @ns-intent-primary" href="https://github.com/palantir/blueprint/wiki/3.0-Changelog" target="_blank" style="margin-top: 30px;">
diff --git a/packages/select/src/components/select/select-component.md b/packages/select/src/components/select/select-component.md
index 1687cb07c23..d6a05f364bd 100644
--- a/packages/select/src/components/select/select-component.md
+++ b/packages/select/src/components/select/select-component.md
@@ -60,19 +60,27 @@ See the code sample in [Item List Renderer API](#select/select-component.item-li
 
 @## Controlled usage
 
-The `InputGroup` value is managed by `Select`'s internal state and is not exposed via props. If you would like to control it, you can circumvent `Select` state by passing your `value` state and `onChange` handler to `inputProps`. You can then query the `items` array directly and omit both predicate props.
+The input value can be controlled with the `query` and `onQueryChange` props. _Do not use `inputProps` for this;_ the component ignores `inputProps.value` and `inputProps.onChange` in favor of `query` and `onQueryChange` (as noted in the prop documentation).
+
+The focused item (for keyboard interactions) can be controlled with the `activeItem` and `onActiveItemChange` props.
 
 ```tsx
-// controlling query involves controlling the input and doing your own filtering
 <FilmSelect
-    inputProps={{ value: this.state.myQuery, onChange: this.handleChange }}
     items={myFilter(ALL_ITEMS, this.state.myQuery)}
     itemRenderer={...}
     onItemSelect={...}
+    // controlled active item
+    activeItem={this.state.myActiveItem}
+    onActiveItemChange={this.handleActiveItemChange}
+    // controlled query
+    query={this.state.myQuery}
+    onQueryChange={this.handleQueryChange}
 />
 ```
 
-This "escape hatch" can be used to implement all sorts of advanced behavior on top of the basic `Select` interactions, such as windowed filtering for large data sets.
+This controlled usage allows you to implement all sorts of advanced behavior on
+top of the basic `Select` interactions, such as windowed filtering for large
+data sets.
 
 @## JavaScript API