From c605686601afc346bfe9f594fd7a9bb3f2e32673 Mon Sep 17 00:00:00 2001
From: Raghav-Sudhakar <raghavendra.s@syncfusion.com>
Date: Sun, 30 Nov 2025 15:59:40 +0530
Subject: [PATCH] 995186-Resolve the ReadMe file length issue in this sample
 repository

---
 README.md | 42 ++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 40 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index feab654..c9db82b 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,40 @@
-# WPF-GettingStarted-Databinding
-This repository contains that sample that how to add the item using binding concept of WPF SfDomainUpDown control.
+# WPF Domain UpDown (SfDomainUpDown) – Getting Started and Data Binding
+
+This sample shows how to use the Syncfusion WPF SfDomainUpDown control to build intuitive, keyboard-friendly pickers for discrete values with full MVVM-friendly data binding. It demonstrates binding to collections, selecting and editing values, wrap/spin behavior, templates for complex items, theming, and best practices for a production-ready experience.
+
+## Features
+- Bind to IEnumerable/ObservableCollection for dynamic item lists
+- Select values via spin buttons, keyboard, and mouse wheel
+- Optional text editing with parsing and read-only modes
+- Wrap behavior when spinning past the first/last item
+- DisplayMemberPath/ItemTemplate for rich item visualization
+- SelectedItem/SelectedIndex two-way binding for MVVM
+- Watermark/placeholder and null-value handling
+- Theming via Syncfusion built-in visual styles
+
+## Getting Started
+1. Create or open a WPF project in Visual Studio (e.g., SfDomainUpDown-GettingStarted).
+2. Install the NuGet package: Syncfusion.SfInput.WPF.
+   - In Visual Studio: Tools > NuGet Package Manager > Manage NuGet Packages for Solution… > Browse “Syncfusion.SfInput.WPF” > Install.
+3. Add the Syncfusion XML namespace in your XAML root:
+   - xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
+4. Place an SfDomainUpDown in your Window/Page and bind it to your ViewModel:
+   - ItemsSource: collection of items to display
+   - SelectedItem or SelectedIndex: current selection
+   - DisplayMemberPath or ItemTemplate: how items are shown
+   - Optional behavior: IsWrapEnabled, IsEditable, SpinButtonAlignment, Watermark
+5. Apply a theme if desired using Syncfusion SkinStorage (VisualStyle):
+   - syncfusion:SkinStorage.VisualStyle="Office2019Colorful" (or any preferred theme)
+
+## Usage Tips
+- For complex objects, prefer ItemTemplate or DisplayMemberPath for clear display.
+- Use two-way binding on SelectedItem/SelectedIndex to keep the ViewModel in sync.
+- Enable IsWrapEnabled for continuous cycling through items.
+- Set IsEditable to allow users to type values and handle parsing/validation as needed.
+- Align spin buttons via SpinButtonAlignment to suit your layout.
+- Provide a Watermark to guide users when no value is selected.
+- Handle SelectionChanged to react to user choices (e.g., filtering or commands).
+
+## About the Sample
+This sample focuses on the essentials for data binding with SfDomainUpDown: wiring ItemsSource, choosing a selection model, configuring spin and wrap behavior, and theming. Extend it by adding validation rules, custom parsing, commands, and richer item templates to match your application’s workflow and branding.
+