assorted docs fixes (mostly links)

gulp/docs.js

@@ -29,7 +29,7 @@ module.exports = (blueprint, gulp, plugins) => {
         new dm.Documentalist({
             markdown: { renderer: text.renderer },
             // must mark our @Decorator APIs as reserved so we can use them in code samples
-            reservedTags: ["ContextMenuTarget", "HotkeysTarget"],
+            reservedTags: ["import", "ContextMenuTarget", "HotkeysTarget"],
         })
             .use(".md", new dm.MarkdownPlugin({ navPage: config.navPage }))
             .use(/\.d\.ts$/, new dm.TypescriptPlugin({

packages/core/src/_typography.scss

@@ -119,6 +119,8 @@ elements:</p>
   <p>And another paragraph.</p>
 </div>
 
+.pt-running-text - Apply larger font size and additional spacing.
+
 Styleguide pt-running-text
 */
 

packages/core/src/components/non-ideal-state/non-ideal-state.md

@@ -4,9 +4,8 @@ parent: components
 
 @# Non-ideal state
 
-[Non-ideal UI states](https://github.com/palantir/blueprint/wiki/Non-ideal-UI-states)
-inform the user that some content is unavailable. There are several types of non-ideal states,
-including:
+Non-ideal UI states inform the user that some content is unavailable. There are several types of
+non-ideal states, including:
 
 * Blank states (when a container has just been created and has no data in it yet,
 or when a container's contents have been intentionally removed)

packages/core/src/docs/typography.md

@@ -29,7 +29,7 @@ font. We provide a class to use the default monospace font instead.
 The base font size for Blueprint web applications is 14px. This should be the default type size
 for most short strings of text which are not headings or titles. If you wish to reset some
 element's font size and line height to the default base styles, use the `.pt-ui-text` class.
-For longer running text, see [running text styles](#typography.running-text).
+For longer running text, see [running text styles](#core/typography.running-text).
 
 @css pt-ui-text
 
@@ -41,7 +41,7 @@ elements:
 
 - `<p>` tags have increased line-height and font size.
 - `<h*>` tag margins are adjusted to provide clear separation between sections in a document.
-- `<ul>` and `<ol>` tags receive [`.pt-list`](#typography.lists) styles for legibility.
+- `<ul>` and `<ol>` tags receive [`.pt-list`](#core/typography.lists) styles for legibility.
 
 @css pt-running-text
 

packages/core/src/docs/variables.md

@@ -2,7 +2,9 @@
 
 Available for use with Sass and Less.
 
-    @import "path/to/@blueprintjs/core/dist/variables";
+```css.scss
+@import "path/to/@blueprintjs/core/dist/variables";
+```
 
 The Sass `$` convention is used in this documentation for consistency with the original source code.
 Every variable mentioned below is also available in `variables.less` with an `@` prefix instead of `$`.
@@ -20,14 +22,14 @@ rare cases where custom styling is necessary and should be used sparingly:
 - `$pt-font-size-large`
 - `$pt-line-height`
 
-See the [Fonts section](#typography.fonts) for more information and usage guidelines.
+See the [Fonts section](#core/typography.fonts) for more information and usage guidelines.
 
 @## Icon variables
 
 Most icons should be displayed using the `span.pt-icon-*` classes or via modifier classes on
 components like `.pt-button`. In rare cases, you may need direct access to the content
 string that generates each icon in the icon font. Blueprint provides these variables with
-straightforward names (see the [Icons section](#icons) for the full list of identifiers):
+straightforward names (see the [Icons section](#core/icons) for the full list of identifiers):
 
 - `$pt-icon-style`
 - `$pt-icon-align-left`

packages/table/src/docs.md

@@ -103,21 +103,21 @@ it belongs has a `loadingOptions` value of `[ ColumnLoadingOption.CELLS ]`. The
 display a table of the largest potentially hazardous asteroid (based on absolute magnitude)
 discovered in a given year.
 
-## Table loading states
+@### Table loading states
 
 `Table` exposes a `loadingOptions` prop that allows you to control the loading state behavior of all
 column header, row header, and body cells. Try toggling the different options.
 
 @reactExample TableLoadingExample
 
-## Column loading states
+@### Column loading states
 
 `Column` exposes a `loadingOptions` prop that allows you to control the loading state behavior of an
 individual column's header and body cells. Try selecting a different column in the dropdown below.
 
 @reactExample ColumnLoadingExample
 
-@## Cells
+@### Cells
 
 `Cell`, `EditableCell`, `ColumnHeaderCell`, and `RowHeaderCell` expose a `loading` prop for granular
 control of which cells should show a loading state. Try selecting a different preset loading