From b426ed50b0823f006fc075c7e3706feb95ca48b5 Mon Sep 17 00:00:00 2001
From: Shrey Jariwala <145821021+shreyjari@users.noreply.github.com>
Date: Tue, 1 Apr 2025 12:19:18 -0400
Subject: [PATCH] Update README.md

---
 README.md | 93 ++++++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 75 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 3302926..432116d 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,82 @@
-# PowerQuery Utilities
+Here's the improved **README.md home page** in clean Markdown format:
 
-A collection of **optimized Power Query (M)** scripts designed to enhance **data transformation, cleaning, and automation** in Power BI.
+```markdown
+# 🚀 PowerQuery Utilities
 
-## 📂 Project Structure
-- **`fx_CleanText`** – Advanced name cleaning function for global datasets.
-- **More Functions Coming Soon...**
+A growing library of **modular Power Query (M)** functions to accelerate your data transformation, cleaning, and automation workflows in **Power BI**.
 
-## Getting Started
-1. Open **Power Query Editor** in Power BI.
-2. Create a Blank query.
-3. Copy the code snippet from (`.pq` file) into the Power Query Advanced Editor.
-4. Apply it in your transformations.
-5. A new query gets created as a function.
-6. Apply the function in your transformation.
+---
 
-## License
-This project is open-source under the **MIT License**.
+## 📦 What's Inside
 
-## Contributing
-Pull requests are welcome! Feel free to submit new **Power Query functions** or improvements.
+| Function | Description |
+|----------|-------------|
+| [`fx_CleanText`](./fx_CleanText/Readme.md) | 🌍 Cleans and formats names from global datasets — supports Unicode, smart casing, multilingual scripts, and more. |
+| *(More functions coming soon...)* | ✨ Stay tuned for reusable modules for deduplication, date parsing, error tracing, and more. |
+
+---
+
+## 🧠 Why This Exists
+
+Power Query is powerful but verbose.  
+This repo provides **plug-and-play scripts** that are:
+
+- 📏 Scalable for large datasets  
+- 🧱 Modular and reusable  
+- 🔍 Transparent and well-documented  
+- 🧑‍💻 Easy to extend for custom scenarios
+
+Whether you're a Power BI beginner or automation pro, this repo helps you skip the grunt work and focus on insights.
+
+---
+
+## 🚀 Getting Started
+
+### ✅ Step 1: Install a Function
+1. Open **Power Query Editor** in Power BI.  
+2. Create a **Blank Query**.  
+3. Paste the code from any `.pq` file (e.g. [`fx_CleanText.pq`](./fx_CleanText/fx_CleanText.pq)).  
+4. Rename the query accordingly (e.g. `fx_CleanText`).  
+
+### ✅ Step 2: Apply the Function to Your Data
+Use in a **Custom Column** or via `Table.TransformColumns`:
+
+```m
+= Table.TransformColumns(Source, {{"Name", fx_CleanText, type text}})
+```
+
+---
+
+## 🔍 Explore Functions by Use Case
+
+| Category        | Available Functions                  |
+|----------------|--------------------------------------|
+| Text Cleaning   | [`fx_CleanText`](./fx_CleanText/Readme.md) |
+| Coming Soon     | fx_RemoveDuplicates, fx_ParseDates, fx_FormatPhoneNumbers |
+
+---
+
+## 🤝 Contribute
+
+Have a cool transformation script?  
+Contributions are welcome! Submit a pull request with:
+
+- 📎 A `.pq` file containing your function  
+- 📝 A minimal README inside a subfolder with usage & examples  
+
+---
+
+## 📝 License
+
+This project is open-source under the **MIT License**.  
+Use it, fork it, ship it — just give credit where it’s due.
+
+---
+
+## 🌐 Resources
 
-## 🔗 Resources
 - [Microsoft Power Query Docs](https://learn.microsoft.com/en-us/power-query/)
-- [Power BI Community](https://community.powerbi.com/)
+- [Power BI Community Forum](https://community.powerbi.com/)
+```
+
+Let me know if you want a second version styled for light themes or a folder-specific `Readme.md` template!