Add documentation on tokens files

Author: paulinea

core/src/main/java/com/orange/ouds/core/theme/OudsBorders.kt

@@ -40,13 +40,33 @@ import com.orange.ouds.theme.tokens.semantic.OudsBorderSemanticTokens
 import java.util.Locale
 
 /**
- * @suppress
+ * Holds all the border-related properties defined in the OUDS theme.
+ *
+ * Borders are used to define boundaries around UI elements to materialise the visual hierarchy and improve usability.
+ *
+ * > Design guidelines: [Border tokens documentation](https://unified-design-system.orange.com/472794e18/p/76909d-border)
+ *
+ * @property width Collection of border width values.
+ * @property radius Collection of border radius values.
+ * @property style Collection of border styles (solid, dashed, etc.).
  */
 data class OudsBorders(
     val width: Width,
     val radius: Radius,
     val style: Style
 ) {
+    /**
+     * Represents the available border widths in OUDS.
+     *
+     * @property none Width of 0 dp, used when no border is visible.
+     * @property default The standard border width used for most cases.
+     * @property thin A thinner border width for subtle separations.
+     * @property medium A medium border width for increased visibility.
+     * @property thick A thick border width for emphasis.
+     * @property thicker A very thick border width for strong emphasis.
+     * @property focus The border width used to indicate focus states.
+     * @property focusInset The width of the inner border (inset) used in focus states to create a double-border effect.
+     */
     data class Width(
         val none: Dp,
         val default: Dp,
@@ -58,6 +78,16 @@ data class OudsBorders(
         val focusInset: Dp
     )
 
+    /**
+     * Represents the available border radius in OUDS.
+     *
+     * @property none No radius (0 dp), resulting in square corners.
+     * @property default The standard radius used for most components.
+     * @property small A small radius for subtle rounding.
+     * @property medium A medium radius for noticeable rounding.
+     * @property large A large radius for significantly rounded corners.
+     * @property pill A fully rounded radius.
+     */
     data class Radius(
         val none: Dp,
         val default: Dp,
@@ -67,6 +97,12 @@ data class OudsBorders(
         val pill: Dp
     )
 
+    /**
+     * Represents the available border styles in OUDS.
+     *
+     * @property default The standard border style (usually solid).
+     * @property drag The specific border style used when an element is being dragged (often dashed).
+     */
     data class Style(
         val default: OudsBorderStyle,
         val drag: OudsBorderStyle