Merge pull request #820 from dburles/docs-core-install

Update documentation for core installation

Author: jxnblk

packages/components/README.md

@@ -3,6 +3,8 @@
 
 Primitive layout, typographic, and other components for use with Theme UI.
 
+**Note:** *This package is included in the main `theme-ui` package and a separate installation is not required.*
+
 ```sh
 npm i @theme-ui/components
 ```

packages/core/README.md

@@ -5,12 +5,14 @@ Core Emotion and JSX implementation for Theme UI
 
 https://theme-ui.com
 
-**Note:** *This package is included in the main `theme-ui` package, and generally should not be used on its own.*
-
 ```sh
 npm i @theme-ui/core
 ```
 
+## Usage
+
+This package is already included in the main `theme-ui` package. However, for a minimal installation, it's possible to install this standalone and then subsequently install only the packages you require.
+
 ## API
 
 - `jsx`

packages/docs/src/pages/packages/components.mdx

@@ -0,0 +1,7 @@
+---
+title: "@theme-ui/components"
+---
+
+import Readme from '@theme-ui/components/README.md'
+
+<Readme />

packages/docs/src/pages/packages/core.mdx

@@ -0,0 +1,7 @@
+---
+title: "@theme-ui/core"
+---
+
+import Readme from '@theme-ui/core/README.md'
+
+<Readme />

packages/docs/src/pages/packages/index.mdx

@@ -11,7 +11,9 @@ In addition to the core library, Theme UI includes several optional packages.
 
 <Cards width={320}>
 
-- [@theme-ui/components](/components)
+- [@theme-ui/core](/packages/core)
+- [@theme-ui/components](/packages/components)
+- [@theme-ui/mdx](/packages/mdx)
 - [@theme-ui/presets](/packages/presets)
 - [@theme-ui/prism](/packages/prism)
 - [@theme-ui/color](/packages/color)

packages/docs/src/pages/packages/mdx.mdx

@@ -0,0 +1,7 @@
+---
+title: "@theme-ui/mdx"
+---
+
+import Readme from '@theme-ui/mdx/README.md'
+
+<Readme />

packages/docs/src/sidebar.mdx

@@ -48,6 +48,9 @@
   - [IconButton](/components/icon-button)
   - [MenuButton](/components/menu-button)
 - [Packages](/packages)
+  - [@theme-ui/core](/packages/core)
+  - [@theme-ui/components](/packages/components)
+  - [@theme-ui/mdx](/packages/mdx)
   - [@theme-ui/presets](/packages/presets)
   - [@theme-ui/prism](/packages/prism)
   - [@theme-ui/color](/packages/color)

packages/mdx/README.md

@@ -5,7 +5,7 @@ MDX component context for Theme UI
 
 https://theme-ui.com
 
-**Note:** *This package is included in the main `theme-ui` package, and generally should not be used on its own.*
+**Note:** *This package is included in the main `theme-ui` package and a separate installation is not required.*
 
 ```sh
 npm i @theme-ui/mdx