Add project files

Author: ElliotOne

README.md

@@ -1 +1,85 @@
-# CSharp-Text-Truncator
+# CSharp-Text-Truncator
+
+## Overview
+
+Welcome to the **CSharp Text Truncator** project! This is a straightforward **C# console application** designed to truncate long text strings gracefully, ensuring they do not exceed a specified maximum length.
+
+The goal of this project is to demonstrate a simple way to shorten text by cutting it off at word boundaries and appending an ellipsis (`...`) when truncated. It's perfect for beginners learning string manipulation in C# or anyone needing a quick utility to truncate text snippets.
+
+---
+
+## Project Structure
+
+- **CSharp-Text-Truncator**: A standalone console app that:
+  - Accepts a long text string.
+  - Truncates the text without breaking words when exceeding a max length.
+  - Outputs both the original and truncated text to the console.
+  - Uses a customizable maximum length setting.
+
+---
+
+## Features
+
+- Truncates text based on a configurable maximum character limit (default: 20).
+- Ensures words are not cut in the middle—truncation happens cleanly at word boundaries.
+- Adds an ellipsis (`...`) to indicate that the text has been shortened.
+- Minimal, easy-to-understand C# implementation.
+- Easily adaptable for different text sources or truncation rules.
+
+---
+
+## How It Works
+
+The app splits the input text into words and iteratively adds them until the total length (including spaces) would exceed the maximum allowed. It then stops and appends `...` to indicate truncation.
+
+---
+
+## Output Example
+
+Original: This is going to be a really really really really really long text!
+Truncated: This is going to be a ...
+
+
+Each run produces the truncated text based on the defined max length.
+
+---
+
+## How to Run
+
+1. Open the solution in **Visual Studio** or your preferred C# IDE.
+2. Set the project as the startup project.
+3. Press `F5` or run the project.
+4. The console will display both the original and truncated text.
+
+---
+
+## Screenshots
+
+### Console Output
+
+![Console Output](https://github.com/ElliotOne/CSharp-Text-Truncator/blob/master/screenshots/first.png)
+
+---
+
+## Technologies Used
+
+- [.NET 6](https://dotnet.microsoft.com/)
+- [C#](https://learn.microsoft.com/en-us/dotnet/csharp/)
+- [Visual Studio](https://visualstudio.microsoft.com/)
+
+---
+
+## License
+
+This project is licensed under the MIT License. Feel free to use, modify, and distribute it.
+
+---
+
+## Contributions
+
+Contributions are very welcome! You can fork the repo, submit issues, or open pull requests to add features such as:
+
+- Custom ellipsis symbols or suffixes.
+- Support for truncating by word count instead of characters.
+- Command-line parameters for input text and max length.
+- GUI or web interface.

screenshots/first.png

@@ -0,0 +1,23 @@
+{
+  "Version": 1,
+  "WorkspaceRootPath": "D:\\1.Projects\\1.Portfolio\\2.OpenSource\\2.Applications_PUSHToGit\\8.CSharp Text Summarizing\\CSharpTextSummarizing\\",
+  "Documents": [],
+  "DocumentGroupContainers": [
+    {
+      "Orientation": 1,
+      "VerticalTabListWidth": 256,
+      "DocumentGroups": [
+        {
+          "DockedHeight": 200,
+          "SelectedChildIndex": -1,
+          "Children": [
+            {
+              "$type": "Bookmark",
+              "Name": "ST:0:0:{1c4feeaa-4718-4aa9-859d-94ce25d182ba}"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

src/.vs/CSharpTextSummarizing/DesignTimeBuild/.dtbcache.v2

@@ -0,0 +1,41 @@
+{
+  "Version": 1,
+  "WorkspaceRootPath": "D:\\1.Projects\\1.Portfolio\\2.OpenSource\\2.Applications_PUSHToGit\\8.CSharp-Text-Summarizer\\CSharpTextSummarizing\\",
+  "Documents": [
+    {
+      "AbsoluteMoniker": "D:0:0:{197EB142-89B6-456D-8B7C-F825E4483141}|CSharpTextSummarizing\\CSharpTextSummarizing.csproj|d:\\1.projects\\1.portfolio\\2.opensource\\2.applications_pushtogit\\8.csharp-text-summarizer\\csharptextsummarizing\\csharptextsummarizing\\program.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}",
+      "RelativeMoniker": "D:0:0:{197EB142-89B6-456D-8B7C-F825E4483141}|CSharpTextSummarizing\\CSharpTextSummarizing.csproj|solutionrelative:csharptextsummarizing\\program.cs||{A6C744A8-0E4A-4FC6-886A-064283054674}"
+    }
+  ],
+  "DocumentGroupContainers": [
+    {
+      "Orientation": 1,
+      "VerticalTabListWidth": 256,
+      "DocumentGroups": [
+        {
+          "DockedHeight": 200,
+          "SelectedChildIndex": 1,
+          "Children": [
+            {
+              "$type": "Bookmark",
+              "Name": "ST:0:0:{1c4feeaa-4718-4aa9-859d-94ce25d182ba}"
+            },
+            {
+              "$type": "Document",
+              "DocumentIndex": 0,
+              "Title": "Program.cs",
+              "DocumentMoniker": "D:\\1.Projects\\1.Portfolio\\2.OpenSource\\2.Applications_PUSHToGit\\8.CSharp-Text-Summarizer\\CSharpTextSummarizing\\CSharpTextSummarizing\\Program.cs",
+              "RelativeDocumentMoniker": "CSharpTextSummarizing\\Program.cs",
+              "ToolTip": "D:\\1.Projects\\1.Portfolio\\2.OpenSource\\2.Applications_PUSHToGit\\8.CSharp-Text-Summarizer\\CSharpTextSummarizing\\CSharpTextSummarizing\\Program.cs",
+              "RelativeToolTip": "CSharpTextSummarizing\\Program.cs",
+              "ViewState": "AgIAAAAAAAAAAAAAAAAAAB4AAAAAAAAAAAAAAA==",
+              "Icon": "ae27a6b0-e345-4288-96df-5eaf394ee369.000738|",
+              "WhenOpened": "2025-06-05T23:17:13.917Z",
+              "EditorCaption": ""
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}