From 65c64285d7a58d507b1be58f08bd7e3eb6d813b5 Mon Sep 17 00:00:00 2001
From: Louis-Maxime Piton <louismaxime.piton@orange.com>
Date: Fri, 2 Aug 2024 13:38:40 +0200
Subject: [PATCH] docs(utilities): add 'Float' page (#2661)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Julien Déramond <julien.deramond@orange.com>
---
 site/content/docs/0.0/utilities/float.md | 44 +++++++++++++++++++++++-
 site/data/sidebar.yml                    |  1 -
 2 files changed, 43 insertions(+), 2 deletions(-)

diff --git a/site/content/docs/0.0/utilities/float.md b/site/content/docs/0.0/utilities/float.md
index e2e0ff7679..f0fa668928 100644
--- a/site/content/docs/0.0/utilities/float.md
+++ b/site/content/docs/0.0/utilities/float.md
@@ -8,4 +8,46 @@ aliases:
 toc: true
 ---
 
-{{< callout-soon "page" >}}
+## Overview
+
+These utility classes float an element to the left or right, or disable floating, based on the current viewport size using the [CSS `float` property](https://developer.mozilla.org/en-US/docs/Web/CSS/float). `!important` is included to avoid specificity issues. These use the same viewport breakpoints as our grid system. Please be aware float utilities have no effect on flex items.
+
+{{< example >}}
+<div class="float-start">Float start on all viewport sizes</div><br>
+<div class="float-end">Float end on all viewport sizes</div><br>
+<div class="float-none">Don't float on all viewport sizes</div>
+{{< /example >}}
+
+<!--Use the [clearfix helper]({{< docsref "/helpers/clearfix" >}}) on a parent element to clear floats.-->
+
+<!--## Responsive
+
+Responsive variations also exist for each `float` value.
+
+{{< example >}}
+<div class="float-sm-end">Float end on viewports sized SM (small) or wider</div><br>
+<div class="float-md-end">Float end on viewports sized MD (medium) or wider</div><br>
+<div class="float-lg-end">Float end on viewports sized LG (large) or wider</div><br>
+<div class="float-xl-end">Float end on viewports sized XL (extra large) or wider</div><br>
+<div class="float-xxl-end">Float end on viewports sized XXL (extra extra large) or wider</div><br>
+{{< /example >}}
+
+Here are all the support classes:
+
+{{< markdown >}}
+{{< float.inline >}}
+{{- range $.Site.Data.breakpoints }}
+- `.float{{ .abbr }}-start`
+- `.float{{ .abbr }}-end`
+- `.float{{ .abbr }}-none`
+{{- end -}}
+{{< /float.inline >}}
+{{< /markdown >}}-->
+
+## CSS
+
+### Sass utilities API
+
+Float utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-float" file="scss/_utilities.scss" >}}
diff --git a/site/data/sidebar.yml b/site/data/sidebar.yml
index df07adef22..d94838a966 100644
--- a/site/data/sidebar.yml
+++ b/site/data/sidebar.yml
@@ -223,7 +223,6 @@
       draft: true
     - title: Flex
     - title: Float
-      draft: true
     - title: Interactions
     - title: Link
       draft: true