From 6e71caf0e7ff189ade83b4ec9062b144ba941e1b Mon Sep 17 00:00:00 2001
From: fzaninotto <fzaninotto@gmail.com>
Date: Tue, 22 Nov 2022 18:40:54 +0100
Subject: [PATCH] Misc doc adjustments

---
 docs/Datagrid.md            | 2 +-
 docs/SelectColumnsButton.md | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/Datagrid.md b/docs/Datagrid.md
index fb1a45b57ac..8da1c9cdb6b 100644
--- a/docs/Datagrid.md
+++ b/docs/Datagrid.md
@@ -800,7 +800,7 @@ const PostList = () => (
 
 ## Showing / Hiding Columns
 
-The [`<SelectColumnsButton>`](./SelectColumnsButton.md) lets users hide or show datagrid columns. 
+The [`<SelectColumnsButton>`](./SelectColumnsButton.md) component lets users hide, show, and reorder datagrid columns. 
 
 ![SelectColumnsButton](./img/SelectColumnsButton.gif)
 
diff --git a/docs/SelectColumnsButton.md b/docs/SelectColumnsButton.md
index 5b17a823e09..f8134222cf2 100644
--- a/docs/SelectColumnsButton.md
+++ b/docs/SelectColumnsButton.md
@@ -9,6 +9,10 @@ This button lets users show or hide columns in a Datagrid. It must be used in co
 
 ![SelectColumnsButton](./img/SelectColumnsButton.gif)
 
+## Usage 
+
+Add the `<SelectColumnsButton>` component to the `<List actions>` prop:
+ 
 ```jsx
 import {
     DatagridConfigurable,
@@ -36,7 +40,7 @@ const PostList = () => (
 );
 ```
 
-**Note**: `<SelectColumnsButton>` doesn't work with `<Datagrid>` - you must use `<DatagridConfigurable>` instead.
+**Note**: `<SelectColumnsButton>` doesn't work with `<Datagrid>` - you must use [`<DatagridConfigurable>`](./Datagrid.md#configurable) instead.
 
 If you want to add the `<SelectColumnsButton>` to the usual List Actions, use the following snippet: