docs: moves Divider stories to the divider folder

Author: Nikolai Lopin

src/components/Divider/docs/Divider.mdx

@@ -0,0 +1,41 @@
+import React from 'react';
+import { Meta, StoryObj } from '@storybook/react';
+import { Divider } from '../Divider';
+import { Box } from '../../Box/Box';
+import { Text } from '../../Text/Text';
+
+const meta: Meta = {
+    title: 'Components/Divider',
+    component: Divider,
+    argTypes: {
+        offset: {
+            description: 'Set margins from surrounding content in css units or Space scale',
+            control: {
+                type: 'text'
+            }
+        }
+    },
+    decorators: [
+        (Story, context) => (
+            <Box display={context.args.vertical ? 'flex' : undefined}>
+                <Text>One</Text>
+                <Story />
+                <Text>Two</Text>
+            </Box>
+        )
+    ]
+};
+
+export default meta;
+
+type Story = StoryObj<typeof Divider>;
+
+export const Default: Story = {};
+
+export const Vertical: Story = {
+    args: { vertical: true }
+};
+
+export const WithoutOffset: Story = {
+    args: { offset: 0 }
+};

src/components/Divider/docs/Divider.stories.tsx

@@ -0,0 +1,39 @@
+import { Meta, ArgTypes, Primary, Stories, Unstyled } from '@storybook/blocks';
+import { Divider, InfoBanner } from '../../index';
+import * as DividerStories from './Divider.stories';
+
+<Meta of={DividerStories} />
+
+# Divider
+
+**Primary UI element for visually separating content**
+
+Renders a divider UI component: horizontal or vertical line that visually separates two pieces of data, content or UI.
+
+<Primary />
+
+### Properties
+
+<ArgTypes of={Divider} />
+
+## Default Behaviour
+
+The horizontal divider takes up the full available width and the vertical divider takes up the full available height.
+
+The horizontal divider is rendered by default. Set **vertical** prop to `true` to change the divider orientation.
+
+## Divider vs Border
+
+The default color of Divider is _$border.primary_ (#C6CDD4), however...
+
+<Unstyled>
+    <InfoBanner
+        variant="warning"
+        description="Divider is NOT a border, and should not be used as such. Please do not use this component as a border for elements."
+        title=""
+    />
+</Unstyled>
+
+Divider is naturally expected to have a certain offset from the elements it is 'dividing' or separating.
+
+<Stories includePrimary={false} />