diff --git a/README.md b/README.md
index ae849e78ac..2f336ffe3e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
# Material Web
-
@@ -22,11 +22,11 @@ open-source design system.
## Resources
-- [Introduction](./docs/intro.md)
-- [Roadmap](./docs/roadmap.md)
-- [Component docs](./docs/components/)
-- [Bundle size](./docs/size.md)
-- [Browser support and FAQ](./docs/support.md)
+- [Introduction](./g3doc/docs/intro.md)
+- [Roadmap](./g3doc/docs/roadmap.md)
+- [Component docs](https://material-web.dev/components/)
+- [Bundle size](./g3doc/docs/size.md)
+- [Browser support and FAQ](./g3doc/docs/support.md)
## Quick start
@@ -35,7 +35,7 @@ open-source design system.
> instead.
This code snippet is a buildless example that loads `@material/web` from a CDN.
-Check out the [quick start](./docs/quick-start.md) guide to install and build
+Check out the [quick start](./g3doc/docs/quick-start.md) guide to install and build
for production.
diff --git a/docs/components/slider.md b/docs/components/slider.md
index 610c0a28b5..15a8e459f5 100644
--- a/docs/components/slider.md
+++ b/docs/components/slider.md
@@ -107,12 +107,36 @@ when either handle is selected.
```
-
+## Accessibility
+
+Add an
+[`aria-label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label)
+attribute to single-handle sliders. For range sliders, provide
+`aria-label-start` and `aria-label-end` for each respective handle.
+
+Use `aria-valuetext` (or `aria-valuetext-start` and `aria-valuetext-end` for
+range sliders) to supply human-readable values to assistive technologies when
+the numeric value requires unit context (such as currency or temperature).
+
+```html
+
+
+
+
+```
## Theming
-Slider supports [Material theming](../theming/README.md) and can be customized
-in terms of color and shape.
+Slider supports
+[Material theming](/third_party/javascript/material/web/g3doc/docs/theming/README.md)
+and can be customized in terms of color and shape.
### Tokens
@@ -160,8 +184,7 @@ Token | Default value
## API
-
-### MdSlider <md-slider>
+### MdSlider ``
#### Properties