Made some improvements to the readme / docs information architecture

Author: Matthew Davidson

packages/bpk-component-autosuggest/readme.md

@@ -2,13 +2,13 @@
 
 > Backpack autosuggest component.
 
-### Installation
+## Installation
 
 ```sh
 npm install bpk-component-autosuggest --save-dev
 ```
 
-### Usage
+## Usage
 
 ```js
 import React, { Component } from 'react';
@@ -108,7 +108,7 @@ class MyComponent extends Component {
 }
 ```
 
-### Props
+## Props
 
 *BpkAutosuggest:*
 

packages/bpk-component-badge/readme.md

@@ -19,7 +19,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property  | PropType        | Required | Default Value |
 | --------- | --------------- | -------- | ------------- |

packages/bpk-component-banner-alert/readme.md

@@ -26,7 +26,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property          | PropType             | Required | Default Value |
 | ----------------- | -------------------- | -------- | ------------- |

packages/bpk-component-blockquote/readme.md

@@ -23,7 +23,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |

packages/bpk-component-breakpoint/readme.md

@@ -21,7 +21,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property  | PropType           | Required | Default Value |
 | --------- | ------------------ | -------- | ------------- |

packages/bpk-component-button/readme.md

@@ -33,7 +33,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property    | PropType | Required | Default Value |
 | ----------- | -------- | -------- | ------------- |

packages/bpk-component-calendar/readme.md

@@ -98,7 +98,7 @@ withCalendarState(composeCalendar(
 ))
 ```
 
-#### Building a custom calendar
+### Building a custom calendar
 
 A custom calendar can be created by swapping out any default component for an alternative:
 
@@ -148,7 +148,7 @@ withCalendarState(composeCalendar(
 > implements the same API (props see below) and provides all the relevant accessibility
 > properties, such as ARIA attributes and `tabIndex`.
 
-### Props
+## Props
 
 | Property              | PropType             | Required | Default Value    |
 | --------------------- | -------------------- | -------- | ---------------- |
@@ -171,7 +171,7 @@ withCalendarState(composeCalendar(
 
 Some of the more complex props and props for sub-components are detailed below.
 
-#### BpkCalendarNav
+### BpkCalendarNav
 
 The BpkCalendarNav component is used to change the month that is being displayed by using
 buttons and a select box.
@@ -186,7 +186,7 @@ buttons and a select box.
 | month                 | Date                 | true     | -                |
 | onMonthChange         | func                 | false    | null             |
 
-#### BpkCalendarGridHeader
+### BpkCalendarGridHeader
 
 The BpkCalendarGridHeader component displays the header of `BpkCalendarGrid`, listing
 the days of the week. This is needed as a separate component, as the header should stay
@@ -199,7 +199,7 @@ in place while the rest of the grid transitions when changing months.
 | weekStartsOn          | number               | true     | -                |
 | showWeekendSeparator  | bool                 | false    | false            |
 
-#### BpkCalendarGrid
+### BpkCalendarGrid
 
 The BpkCalendarGrid component displays a month as a table.
 
@@ -223,7 +223,7 @@ The BpkCalendarGrid component displays a month as a table.
 | showWeekendSeparator  | bool                 | false    | true             |
 | weekStartsOn          | number               | false    | 1                |
 
-#### BpkCalendarDate
+### BpkCalendarDate
 
 The BpkCalendarDate component is used to render the content of a cell
 (a single day) inside the calendar grid.
@@ -241,9 +241,9 @@ The BpkCalendarDate component is used to render the content of a cell
 | onDateKeyDown         | func                 | false    | null             |
 | preventKeyboardFocus  | bool                 | false    | true             |
 
-#### Prop details
+### Prop details
 
-##### daysOfWeek
+#### daysOfWeek
 
 An array of objects describing the days of the week:
 
@@ -271,14 +271,14 @@ An array of objects describing the days of the week:
 ]
 ```
 
-##### fixedWidth
+#### fixedWidth
 
 If set to true (default), it sets a fixed width on the calendar container. This is necessary to support
 transitions and to create the right size for the Datepicker component.
 
 If set to false, the calendar is of fluid width and will take up the space of its parent container.
 
-##### formatDateFull
+#### formatDateFull
 
 A function to format a full, human-readable date, for example: "Friday, 13th January 2017":
 
@@ -288,7 +288,7 @@ import format from 'date-fns/format';
 const formatDateFull = date => format(date, 'dddd, Do MMMM YYYY');
 ```
 
-##### formatMonth
+#### formatMonth
 
 A function to format a human-readable month, for example: "January 2017":
 
@@ -300,6 +300,6 @@ import format from 'date-fns/format';
 const formatMonth = date => format(date, 'MMMM YYYY');
 ```
 
-##### weekStartsOn
+#### weekStartsOn
 
 First day of the week. 0 = Sunday, 1 = Monday, ..., 6 = Saturday.

packages/bpk-component-card/readme.md

@@ -23,7 +23,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |

packages/bpk-component-checkbox/readme.md

@@ -24,7 +24,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |

packages/bpk-component-close-button/readme.md

@@ -19,7 +19,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property | PropType | Required | Default Value |
 | -------- | -------- | -------- | ------------- |

packages/bpk-component-code/readme.md

@@ -31,7 +31,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 *For BpkCode & BpkCodeBlock:*
 

packages/bpk-component-content-container/readme.md

@@ -22,7 +22,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property                | PropType                                     | Required | Default Value |
 | ----------------------- | -------------------------------------------- | -------- | ------------- |

packages/bpk-component-datepicker/readme.md

@@ -65,7 +65,7 @@ class App extends Component {
 }
 ```
 
-### Props
+## Props
 
 For more information on some these props, check the BpkCalendar documentation.
 

packages/bpk-component-fieldset/readme.md

@@ -54,7 +54,7 @@ class FieldsetContainer extends Component {
 }
 ```
 
-### Props
+## Props
 
 | Property          | PropType | Required | Default Value |
 | ----------------- | -------- | -------- | ------------- |

packages/bpk-component-form-validation/readme.md

@@ -21,7 +21,7 @@ export default () => (
 )
 ```
 
-### Props
+## Props
 
 | Property       | PropType | Required | Default Value |
 | -------------- | -------- | -------- | ------------- |

packages/bpk-component-grid-toggle/readme.md

@@ -19,7 +19,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property         | PropType | Required | Default Value |
 | ---------------- | -------- | -------- | ------------- |

packages/bpk-component-grid/readme.md

@@ -58,24 +58,24 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
-*BpkGridContainer:*
+### BpkGridContainer
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |
 | children  | node     | true     | -             |
 | debug     | bool     | false    | false         |
 | fullWidth | bool     | false    | false         |
 
-*BpkGridRow:*
+### BpkGridRow
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |
 | children  | node     | true     | -             |
 | padded    | bool     | false    | true          |
 
-*BpkGridColumn:*
+### BpkGridColumn
 
 | Property     | PropType | Required | Default Value |
 | ------------ | -------- | -------- | ------------- |

packages/bpk-component-heading/readme.md

@@ -19,7 +19,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property     | PropType                           | Required | Default Value |
 | ------------ | ---------------------------------- | -------- | ------------- |

packages/bpk-component-horizontal-nav/readme.md

@@ -23,17 +23,17 @@ export default () => (
 )
 ```
 
-### Props
+## Props
 
-*BpkHorizontalNav:*
+### BpkHorizontalNav
 
 | Property    | PropType | Required | Default Value |
 | ----------- | -------- | -------- | ------------- |
 | children    | node     | true     | -             |
 | className   | string   | false    | null          |
 | spaceAround | bool     | false    | false         |
 
-*BpkHorizontalNavItem:*
+### BpkHorizontalNavItem
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |

packages/bpk-component-icon/readme.md

@@ -38,7 +38,7 @@ export default () => (
 }
 ```
 
-## Aligning to BpkButton components
+### Aligning to BpkButton components
 
 ```js
 import React from 'react';
@@ -64,7 +64,7 @@ export default () => (
 );
 ```
 
-## RTL support
+### RTL support
 
 ```js
 import React from 'react';

packages/bpk-component-input/readme.md

@@ -26,7 +26,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property     | PropType             | Required  | Default Value    |
 | ------------ | -------------------- | --------- | ---------------- |

packages/bpk-component-label/readme.md

@@ -19,7 +19,7 @@ export default () => (
 )
 ```
 
-### Props
+## Props
 
 | Property  | PropType | Required | Default Value |
 | --------- | -------- | -------- | ------------- |

packages/bpk-component-link/readme.md

@@ -22,9 +22,9 @@ export default () => (
 )
 ```
 
-### Props
+## Props
 
-*BpkLink:*
+### BpkLink
 
 | Property | PropType | Required | Default Value |
 | -------- | -------- | -------- | ------------- |
@@ -34,7 +34,7 @@ export default () => (
 | blank    | bool     | false    | false         |
 | white    | bool     | false    | false         |
 
-*BpkLinkButton:*
+### BpkLinkButton
 
 | Property | PropType | Required | Default Value |
 | -------- | -------- | -------- | ------------- |

packages/bpk-component-list/readme.md

@@ -30,16 +30,16 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
-*BpkList:*
+### BpkList
 
 | Property | PropType | Required | Default Value |
 | -------- | -------- | -------- | ------------- |
 | children | -        | true     | -             |
 | ordered  | bool     | false    | false         |
 
-*BpkListItem:*
+### BpkListItem
 
 | Property | PropType | Required | Default Value |
 | -------- | -------- | -------- | ------------- |

packages/bpk-component-loading-button/readme.md

@@ -33,7 +33,7 @@ export default () => (
 );
 ```
 
-### Props
+## Props
 
 | Property     | PropType | Required | Default Value |
 | ------------ | -------- | -------- | ------------- |