diff --git a/docs/basics/data/data-binding/data-binding-syntax.md b/docs/basics/data/data-binding/data-binding-syntax.md
index 4636260e7..1ae773138 100644
--- a/docs/basics/data/data-binding/data-binding-syntax.md
+++ b/docs/basics/data/data-binding/data-binding-syntax.md
@@ -194,7 +194,7 @@ be `(r: 100, g: 80, b: 255)`.
:::tip
An alternative is to use an `InlineCollection` of `Run` elements each with their own single parameter
-binding. This allows visual customization of each segment. See the example [here](/docs/reference/controls/detailed-reference/textblock#run)
+binding. This allows visual customization of each segment. See the example [here](/docs/reference/controls/textblock#run)
:::
### Built-in Conversions
diff --git a/docs/basics/user-interface/controls/builtin-controls.md b/docs/basics/user-interface/controls/builtin-controls.md
index d0f069ae5..0189a1d28 100644
--- a/docs/basics/user-interface/controls/builtin-controls.md
+++ b/docs/basics/user-interface/controls/builtin-controls.md
@@ -6,7 +6,7 @@ Here are some of the more commonly-used Avalonia controls, organized by category
| Control |Description|
|:-------------------------------------------------------------------------------|:----|
-| [Border](../../../reference/controls/detailed-reference/border.md) |Decorates a single child with a border and background.|
+| [Border](../../../reference/controls/border.md) |Decorates a single child with a border and background.|
| [Canvas](../../../reference/controls/canvas.md) |Displays child controls at specified positions.|
| [Dock Panel](../../../reference/controls/dockpanel.md) |Arranges child controls along specified edges (top, bottom, left, right) with one filling any remaining space.|
| [Expander](../../../reference/controls/expander.md) |Has a header area (always visible) and a collapsible content section (single child).|
@@ -17,9 +17,9 @@ Here are some of the more commonly-used Avalonia controls, organized by category
| [Scroll Viewer](../../../reference/controls/scrollviewer.md) |Adds scroll bars and scrolling behavior if the (single) child is larger than the space available.|
| [Split View](../../../reference/controls/splitview.md) |Adds a collapsible pane to the edge of its (single child) content zone.|
| [Stack Panel](../../../reference/controls/stackpanel.md) |Allows multiple child controls, arranged in sequence, horizontally or vertically.|
-| [Tab Control](../../../reference/controls/detailed-reference/tabcontrol.md) |The tab control allows you to sub-divide a view into tab items.|
-| [Uniform Grid](../../../reference/controls/detailed-reference/uniform-grid.md) |Allows multiple child controls, arranged in a grid with cells of uniform column and row size.|
-| [Wrap Panel](../../../reference/controls/detailed-reference/wrappanel.md) |Arranges child controls in sequence from left to right, while they fit in the width. Starts a new line when there is no space left.|
+| [Tab Control](../../../reference/controls/tabcontrol.md) |The tab control allows you to sub-divide a view into tab items.|
+| [Uniform Grid](../../../reference/controls/uniform-grid.md) |Allows multiple child controls, arranged in a grid with cells of uniform column and row size.|
+| [Wrap Panel](../../../reference/controls/wrappanel.md) |Arranges child controls in sequence from left to right, while they fit in the width. Starts a new line when there is no space left.|
## Buttons
@@ -50,9 +50,9 @@ These controls display repeating data, in either a tabular or list format:
|Control|Description|
|:----|:----|
|[AutoCompleteBox](../../../reference/controls/autocompletebox.md)|A control that shows a text box for user input and a drop-down that contains possible matches based on what has been typed.|
-|[TextBlock](../../../reference/controls/detailed-reference/textblock.md)|A control that displays a block of text. Read-only.|
-|[TextBox](../../../reference/controls/detailed-reference/textbox.md)|Used to display or edit text without formatting restrictions.|
-|[SelectableTextBlock](../../../reference/controls/detailed-reference/selectable-textblock.md)|Used to display or edit text without formatting restrictions. Allows selecting and copying.|
+|[TextBlock](../../../reference/controls/textblock.md)|A control that displays a block of text. Read-only.|
+|[TextBox](../../../reference/controls/textbox.md)|Used to display or edit text without formatting restrictions.|
+|[SelectableTextBlock](../../../reference/controls/selectable-textblock.md)|Used to display or edit text without formatting restrictions. Allows selecting and copying.|
|[MaskedTextBox](../../../reference/controls/maskedtextbox.md)|Used to display text in the format contained in a mask; or used to edit text using the format mask to prevent invalid user input.|
## Value selection
@@ -61,18 +61,18 @@ These controls display repeating data, in either a tabular or list format:
|:----|:----|:----|
|[CheckBox](../../../reference/controls/checkbox.md)|Boolean|True value presented as a check mark. Click interaction toggles the value. Has an option to display an 'unknown' value.|
|[Slider](../../../reference/controls/slider.md)|Double|Relative value compared to a maximum and minimum value presented as the position along the length of the slider track of the slider button. Drag interaction on the slider button can alter the value between the maximum and minimum values. Keyboard and click interactions can also nudge the value.|
-|[Calendar](../../../reference/controls/detailed-reference/calendar)|DateTime|The calendar is a control for users to select dates or date ranges.|
-|[CalendarDatePicker](../../../reference/controls/detailed-reference/calendar/calendar-date-picker.md)|DateTime|An extension of the calendar control that includes a text box and button.|
+|[Calendar](../../../reference/controls/calendar)|DateTime|The calendar is a control for users to select dates or date ranges.|
+|[CalendarDatePicker](../../../reference/controls/calendar/calendar-date-picker.md)|DateTime|An extension of the calendar control that includes a text box and button.|
|[ColorPicker](../../../reference/controls/colorpicker)|Color / HsvColor|The color picker supports user-selection and editing of colors using a spectrum, palette and component sliders. It also supports an optional alpha component, RGB or HSV color models and hexadecimal color values.|
|[DatePicker](../../../reference/controls/datepicker.md)|DateTime|The date picker has three 'spinner' controls to allow the user to pick a date value.|
-|[TimePicker](../../../reference/controls/detailed-reference/timepicker.md)|TimeSpan|The time picker has three 'spinner' controls to allow the user to pick a time from hours, minutes and seconds.|
+|[TimePicker](../../../reference/controls/timepicker.md)|TimeSpan|The time picker has three 'spinner' controls to allow the user to pick a time from hours, minutes and seconds.|
## Displaying images
|Control|Description|
|:----|:----|
|[Image](../../../reference/controls/image.md)|Displays a bitmap or vector image.|
-|[PathIcon](../../../reference/controls/detailed-reference/path-icon.md)|Draws a vector image using the current `Foreground`.|
+|[PathIcon](../../../reference/controls/path-icon.md)|Draws a vector image using the current `Foreground`.|
## Menus and Popups
@@ -80,4 +80,4 @@ These controls display repeating data, in either a tabular or list format:
|:----|:----|
|[Menu](../../../reference/controls/menu.md)|Displays an application menu.|
|[Flyouts](../../../reference/controls/flyouts.md)|Attaches a popup or a context menu to a control.|
-|[ToolTip](../../../reference/controls/detailed-reference/tooltip.md)|Displays a tool tip when a control is hovered.|
+|[ToolTip](../../../reference/controls/tooltip.md)|Displays a tool tip when a control is hovered.|
diff --git a/docs/basics/user-interface/controls/index.md b/docs/basics/user-interface/controls/index.md
index b85f07a6f..c4a306fad 100644
--- a/docs/basics/user-interface/controls/index.md
+++ b/docs/basics/user-interface/controls/index.md
@@ -20,8 +20,8 @@ These are just a few examples of the many controls available in Avalonia UI. Eac
To get started with using controls in Avalonia UI, you can refer to the documentation for each control type. The documentation provides detailed explanations, examples, and code snippets to help you understand and utilize the controls effectively.
- [Button Control Documentation](../../../reference/controls/buttons/button)
-- [TextBox Control Documentation](../../../reference/controls/detailed-reference/textbox)
-- [Label Control Documentation](../../../reference/controls/detailed-reference/label)
+- [TextBox Control Documentation](../../../reference/controls/textbox)
+- [Label Control Documentation](../../../reference/controls/label)
- [Checkbox Control Documentation](../../../reference/controls/checkbox)
- [Slider Control Documentation](../../../reference/controls/slider)
- [ListBox Control Documentation](../../../reference/controls/listbox)
diff --git a/docs/concepts/custom-itemspanel.md b/docs/concepts/custom-itemspanel.md
index bfdb9f1aa..b96b5adb4 100644
--- a/docs/concepts/custom-itemspanel.md
+++ b/docs/concepts/custom-itemspanel.md
@@ -9,7 +9,7 @@ import ItemsControlCanvasScreenshot from '/img/concepts/itemscontrol-with-canvas
All `ItemsControl`s have an item container panel which is used to layout their items. It is possible to override the type of panel used by the control to achieve custom/alternative layouts of items in a control. This document provides some examples showcasing how and why you would do this.
- [`ItemsControl`](./../reference/controls/itemscontrol)
-- [`TreeView`](./../reference/controls/detailed-reference/treeview-1)
+- [`TreeView`](./../reference/controls/treeview-1)
- [`Carousel`](./../reference/controls/carousel)
- [`Menu`](./../reference/controls/menu)
- [`ComboBox`](./../reference/controls/combobox)
diff --git a/docs/reference/controls/border.md b/docs/reference/controls/border.md
index 4f0d4e9df..a22a2cee2 100644
--- a/docs/reference/controls/border.md
+++ b/docs/reference/controls/border.md
@@ -2,8 +2,8 @@
description: REFERENCE - Built-in Controls
---
-import BorderPodLookScreenshot from '/img/reference/controls/detailed-reference/border/border-pod-look.png';
-import BorderDropShadowScreenshot from '/img/reference/controls/detailed-reference/border/border-drop-shadow.png';
+import BorderPodLookScreenshot from '/img/reference/controls/border/border-pod-look.png';
+import BorderDropShadowScreenshot from '/img/reference/controls/border/border-drop-shadow.png';
# Border
diff --git a/docs/reference/controls/image-controls.md b/docs/reference/controls/image-controls.md
index 374f8f44d..ab84db20a 100644
--- a/docs/reference/controls/image-controls.md
+++ b/docs/reference/controls/image-controls.md
@@ -12,6 +12,6 @@ If you plan to bind an image source, you will need to use an image converter. To
| | | |
| ---------------------------------------------------- | ------------------------------------------------ | - |
-| [DrawingImage](detailed-reference/drawing-image.md) | Displays a vector image. | |
+| [DrawingImage](./drawing-image.md) | Displays a vector image. | |
| [Image](image.md) | Displays a bitmap image. | |
-| [PathIcon](detailed-reference/path-icon.md) | Draws an icon from stream geometry instructions. | |
+| [PathIcon](./path-icon.md) | Draws an icon from stream geometry instructions. | |
diff --git a/docs/reference/controls/image.md b/docs/reference/controls/image.md
index 90b46f8ae..d19570796 100644
--- a/docs/reference/controls/image.md
+++ b/docs/reference/controls/image.md
@@ -18,7 +18,7 @@ Images can be used to compose the content of another control. For example, you c
The image displayed can be resized and scaled. The default settings for scaling (uniform stretch in both directions) will result in the image being fitted to the size (width and/or height) given.
:::info
-The scaling settings for an image are the same as for the view box, see the reference [here](detailed-reference/viewbox.md).
+The scaling settings for an image are the same as for the view box, see the reference [here](./viewbox.md).
:::
## Example
diff --git a/docs/reference/controls/layout-controls.md b/docs/reference/controls/layout-controls.md
index 10b4c9f67..995a7b55c 100644
--- a/docs/reference/controls/layout-controls.md
+++ b/docs/reference/controls/layout-controls.md
@@ -10,4 +10,4 @@ Layout controls allow you to use **UI Composition** to arrange your UI in a vari
To review the concepts behind **UI Composition**, see [here](../../concepts/ui-composition).
:::
-
Control | Description |
---|
Border | Decorates a single child with a border and background. |
Canvas | Displays child controls at specified positions. |
DockPanel | Arranges child controls along specified edges (top, bottom, left, right) with one filling any remaining space. |
Expander | Has a header area (always visible) and a collapsible content section (single child). |
Grid | Arranges child controls in the cells of a grid, positioned by row and column. The cells can span rows and columns. |
GridSplitter | Can be added to a grid to allow the user to resize rows or columns at runtime. |
Panel | Allows multiple child controls, displayed in sequence. Layout calculated by child size and alignments (horizontal and vertical), relative to the panel itself. |
RelativePanel | Allows multiple child controls. The position and alignment of the child controls can be specified in relation to the panel itself, or in relation to other child controls. The size of child controls can be specified, or calculated from relations and alignments. |
ScrollBar | |
ScrollViewer | Adds scroll bars and scrolling behaviour if the (single) child is larger than the space available. |
SplitView | Adds a collapsible pane to the edge of its (single child) content zone. |
StackPanel | Allows multiple child controls, arranged in sequence, horizontally or vertically. |
TabControl | The tab control allows you to sub-divide a view into tab items. |
UniformGrid | Allows multiple child controls, arranged in a grid with cells of uniform column and row size. |
WrapPanel | Arranges (multiple) child controls in sequence from left to right, while they fit in the width. Starts a new line when there is no space left. |
+Control | Description |
---|
Border | Decorates a single child with a border and background. |
Canvas | Displays child controls at specified positions. |
DockPanel | Arranges child controls along specified edges (top, bottom, left, right) with one filling any remaining space. |
Expander | Has a header area (always visible) and a collapsible content section (single child). |
Grid | Arranges child controls in the cells of a grid, positioned by row and column. The cells can span rows and columns. |
GridSplitter | Can be added to a grid to allow the user to resize rows or columns at runtime. |
Panel | Allows multiple child controls, displayed in sequence. Layout calculated by child size and alignments (horizontal and vertical), relative to the panel itself. |
RelativePanel | Allows multiple child controls. The position and alignment of the child controls can be specified in relation to the panel itself, or in relation to other child controls. The size of child controls can be specified, or calculated from relations and alignments. |
ScrollBar | |
ScrollViewer | Adds scroll bars and scrolling behaviour if the (single) child is larger than the space available. |
SplitView | Adds a collapsible pane to the edge of its (single child) content zone. |
StackPanel | Allows multiple child controls, arranged in sequence, horizontally or vertically. |
TabControl | The tab control allows you to sub-divide a view into tab items. |
UniformGrid | Allows multiple child controls, arranged in a grid with cells of uniform column and row size. |
WrapPanel | Arranges (multiple) child controls in sequence from left to right, while they fit in the width. Starts a new line when there is no space left. |
diff --git a/docs/reference/controls/menu-controls.md b/docs/reference/controls/menu-controls.md
index 57db7c453..685a97971 100644
--- a/docs/reference/controls/menu-controls.md
+++ b/docs/reference/controls/menu-controls.md
@@ -6,4 +6,4 @@ description: REFERENCE - Built-in Controls
Menu controls allow you to add menus to your _Avalonia UI_ app.
-Control | Description |
---|
ContextMenu | A context menu to attach to a control. |
Menu | A menu that can act as a top-level menu on a window. |
NativeMenu | Displays a native menu on macOS and some Linux distributions. |
TabStrip | The `TabStrip` acts like a horizontal menu. |
+Control | Description |
---|
ContextMenu | A context menu to attach to a control. |
Menu | A menu that can act as a top-level menu on a window. |
NativeMenu | Displays a native menu on macOS and some Linux distributions. |
TabStrip | The `TabStrip` acts like a horizontal menu. |
diff --git a/docs/reference/controls/menu-flyout.md b/docs/reference/controls/menu-flyout.md
index b329c5e45..277f2aa51 100644
--- a/docs/reference/controls/menu-flyout.md
+++ b/docs/reference/controls/menu-flyout.md
@@ -3,18 +3,18 @@ title: MenuFlyout
description: REFERENCE - Built-in Controls
---
-import MenuFlyoutScreenshot from '/img/reference/controls/detailed-reference/menuflyout/menuflyout-button.gif';
+import MenuFlyoutScreenshot from '/img/reference/controls/menuflyout/menuflyout-button.gif';
# MenuFlyout
A 'MenuFlyout' allows you to host a simple menu as the flyout for a control. You might use this as an alternative to the context menu.
:::info
-For details of the context menu, see the reference [here](./contextmenu.md).
+For details of the context menu, see the reference [here](./contextmenu).
:::
-:::info
-The properties of a menu flyout are the same as for a flyout. See [here](./flyouts.md).
+:::infos
+The properties of a menu flyout are the same as for a flyout. See [here](flyouts).
:::
## Example
diff --git a/docs/reference/controls/nativemenu.md b/docs/reference/controls/nativemenu.md
index 3bd111fe7..394d6c64e 100644
--- a/docs/reference/controls/nativemenu.md
+++ b/docs/reference/controls/nativemenu.md
@@ -8,7 +8,7 @@ description: REFERENCE - Built-in Controls
The `NativeMenu` can display a menu on _macOS_ and some Linux distributions.
:::warning
-This control can only be used attached to a tray icon. For full details about the tray icon, see the reference [here](detailed-reference/tray-icon.md).
+This control can only be used attached to a tray icon. For full details about the tray icon, see the reference [here](./tray-icon.md).
:::
You can create sub-menus by nesting `