diff --git a/README.md b/README.md
index a830cdfd..b84646aa 100644
--- a/README.md
+++ b/README.md
@@ -5,13 +5,25 @@
[![Build][build]][build-badge]
-carbon-components-svelte is a Svelte component library that implements the [Carbon Design System](https://github.com/carbon-design-system), an open source design system by IBM.
+Carbon Components Svelte is a [Svelte](https://github.com/sveltejs/svelte) component library that implements the [Carbon Design System](https://github.com/carbon-design-system), an open source design system by IBM.
-A design system can facilitate frontend development and prototyping because it encourages reuse, consistency, and extensibility.
+Design systems facilitate design and development through reuse, consistency, and extensibility.
+
+The Carbon Svelte portfolio also includes:
+
+- **[Carbon Icons Svelte](https://github.com/IBM/carbon-icons-svelte)**: 5800+ Carbon icons as Svelte components
+- **[Carbon Pictograms Svelte](https://github.com/IBM/carbon-pictograms-svelte)**: 600+ Carbon pictograms as Svelte components
+- **[Carbon Charts Svelte](https://github.com/carbon-design-system/carbon-charts/tree/master/packages/svelte)**: 16 chart types, powered by d3
## [Documentation](http://ibm.biz/carbon-svelte)
-
+
+
+The [documentation website](http://ibm.biz/carbon-svelte) contains live demos and examples. Other forms of documentation are auto-generated:
+
+- **[Component Index](COMPONENT_INDEX.md)**: Markdown file documenting component props, slots, and events
+- **[TypeScript definitions](types)**: Component TypeScript definitions
+- **[Component API](docs/src/COMPONENT_API.json)**: Component API metadata in JSON format
## Getting started
diff --git a/docs/src/components/ComponentApi.svelte b/docs/src/components/ComponentApi.svelte
index d3b3376a..75356c97 100644
--- a/docs/src/components/ComponentApi.svelte
+++ b/docs/src/components/ComponentApi.svelte
@@ -138,7 +138,10 @@
{#if prop.description}
{#each prop.description.split('\n') as line}
{/each}
{:else}
diff --git a/docs/src/pages/components/OrderedList.svx b/docs/src/pages/components/OrderedList.svx
index e8275202..58b5bfb6 100644
--- a/docs/src/pages/components/OrderedList.svx
+++ b/docs/src/pages/components/OrderedList.svx
@@ -51,6 +51,8 @@ components: ["OrderedList", "ListItem"]
### Native list styles
+Use the `native` attribute to enable default browser list styles. This is useful for large lists (i.e., 1000 or more items) where the list number may overlap with the list item text.
+
Ordered list level 1
diff --git a/docs/src/pages/index.svelte b/docs/src/pages/index.svelte
index db977621..395a59ed 100644
--- a/docs/src/pages/index.svelte
+++ b/docs/src/pages/index.svelte
@@ -25,7 +25,7 @@
Carbon Components Svelte
- carbon-components-svelte is a
+ Carbon Components Svelte is a
- A design system can facilitate frontend development and prototyping
- because it encourages reuse, consistency, and extensibility.
+ Design systems facilitate design and development through reuse,
+ consistency, and extensibility.
@@ -74,8 +74,8 @@
Portfolio
- The broader Carbon Svelte effort extends to the icons, pictograms, and
- data visualization libraries.
+ The broader Carbon Svelte effort includes libraries for icons,
+ pictograms, and data visualization.
