refactor: solution reorganization, added repo-wide conventions and docs

rudironsoni · rudironsoni · commit 7b8bfff119f8 · 2026-01-23T10:09:32.000+01:00
- Add .editorconfig and Directory.Build.props for code style and project-wide settings
- Update project files to target netstandard2.1 (libraries) and net10 (tests/benchmarks)
- Add README.md and DSA.md with project structure and namespace conventions
- Update .gitignore for IDE and OS-specific files
- Add GitHub Actions CI workflow for build, test, and benchmarks
- Add vcs.xml for commit message inspection
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,9 @@
+root = true
+
+[*.cs]
+indent_style = space
+indent_size = 4
+dotnet_sort_system_directives_first = true
+csharp_style_namespace_declarations = file_scoped:suggestion
+
+# Enforce namespace prefix (RudiRonsoni) via a manual convention; tooling can be added later.
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET 10 SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: Install NuGet packages
+        run: dotnet restore
+
+      - name: Build solution
+        run: dotnet build C-Sharp-Data-Structures-and-Algorithms.sln --configuration Release --no-restore
+
+      - name: Run tests
+        run: dotnet test C-Sharp-Data-Structures-and-Algorithms.sln --configuration Release --no-build --verbosity normal
+
+  benchmarks:
+    runs-on: ubuntu-latest
+    needs: build-and-test
+    if: github.event_name == 'workflow_dispatch' || contains(github.event.head_commit.message, '[bench]')
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup .NET 10 SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+      - name: Run benchmarks (manual/conditional)
+        run: |
+          dotnet run -p DSA/Algorithms/AlgorithmsBenchmarks/AlgorithmsBenchmarks.csproj --configuration Release
diff --git a/.gitignore b/.gitignore
@@ -896,4 +896,8 @@ FodyWeavers.xsd
 *.sln.iml
 
 # MacOS .DS_Store
-.DS_Store
+.DS_Store
+/.idea/.idea.C-Sharp-Data-Structures-and-Algorithms/.idea/copilot.data.migration.agent.xml
+/.idea/.idea.C-Sharp-Data-Structures-and-Algorithms/.idea/copilot.data.migration.ask.xml
+/.idea/.idea.C-Sharp-Data-Structures-and-Algorithms/.idea/copilot.data.migration.edit.xml
+/.idea/.idea.C-Sharp-Data-Structures-and-Algorithms/.idea/GitLink.xml
diff --git a/.idea/.idea.C-Sharp-Data-Structures-and-Algorithms/.idea/vcs.xml b/.idea/.idea.C-Sharp-Data-Structures-and-Algorithms/.idea/vcs.xml
diff --git a/DSA/Algorithms/Algorithms/Algorithms.csproj b/DSA/Algorithms/Algorithms/Algorithms.csproj
@@ -1,9 +1,7 @@
 ﻿<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>netstandard2.1</TargetFramework>
     </PropertyGroup>
 
 </Project>
diff --git a/DSA/Algorithms/AlgorithmsBenchmarks/AlgorithmsBenchmarks.csproj b/DSA/Algorithms/AlgorithmsBenchmarks/AlgorithmsBenchmarks.csproj
@@ -2,9 +2,7 @@
 
     <PropertyGroup>
         <OutputType>Exe</OutputType>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>net10.0</TargetFramework>
     </PropertyGroup>
 
 </Project>
diff --git a/DSA/Algorithms/AlgorithmsTests/AlgorithmsTests.csproj b/DSA/Algorithms/AlgorithmsTests/AlgorithmsTests.csproj
@@ -1,9 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>net10.0</TargetFramework>
 
         <IsPackable>false</IsPackable>
         <IsTestProject>true</IsTestProject>
diff --git a/DSA/DataStructures/DataStructures/DataStructures.csproj b/DSA/DataStructures/DataStructures/DataStructures.csproj
@@ -1,9 +1,7 @@
 ﻿<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>netstandard2.1</TargetFramework>
     </PropertyGroup>
 
 </Project>
diff --git a/DSA/DataStructures/DataStructuresBenchmarks/DataStructuresBenchmarks.csproj b/DSA/DataStructures/DataStructuresBenchmarks/DataStructuresBenchmarks.csproj
@@ -2,9 +2,7 @@
 
     <PropertyGroup>
         <OutputType>Exe</OutputType>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>net10.0</TargetFramework>
     </PropertyGroup>
 
 </Project>
diff --git a/DSA/DataStructures/DataStructuresTests/DataStructuresTests.csproj b/DSA/DataStructures/DataStructuresTests/DataStructuresTests.csproj
@@ -1,9 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>net10.0</TargetFramework>
 
         <IsPackable>false</IsPackable>
         <IsTestProject>true</IsTestProject>
diff --git a/Directory.Build.props b/Directory.Build.props
@@ -0,0 +1,15 @@
+<Project>
+  <PropertyGroup>
+    <!-- Root namespace for all projects -->
+    <RootNamespace>RudiRonsoni</RootNamespace>
+
+    <!-- C# language version -->
+    <LangVersion>latest</LangVersion>
+
+    <!-- Enable nullable reference types across the repo -->
+    <Nullable>enable</Nullable>
+
+    <!-- Enable implicit usings for runnable SDK targets (net10); netstandard2.1 does not support implicit usings -->
+    <ImplicitUsings Condition=" '$(TargetFramework)' != 'netstandard2.1' ">enable</ImplicitUsings>
+  </PropertyGroup>
+</Project>
diff --git a/Docs/DSA/DSA.md b/Docs/DSA/DSA.md
@@ -0,0 +1,12 @@
+# DSA taxonomy
+
+This document maps repository folders to feature-driven namespaces with root `RudiRonsoni`.
+
+Examples:
+
+- `DSA/Algorithms` -> `RudiRonsoni.Algorithms`
+- `DSA/Algorithms/Sorting` -> `RudiRonsoni.Algorithms.Sorting`
+- `DSA/DataStructures/Trees` -> `RudiRonsoni.DataStructures.Trees`
+- `Exercises/Arrays` -> `RudiRonsoni.Exercises.Arrays`
+
+Migration notes: use IDE rename/refactor to migrate namespaces to the feature-driven convention. Libraries target `netstandard2.1`; runnable projects and tests target `net10`.
diff --git a/Docs/README.md b/Docs/README.md
@@ -0,0 +1,3 @@
+Docs for the repository.
+
+See `Docs/DSA/DSA.md` for the data structures and algorithms taxonomy and namespace mapping.
diff --git a/Exercises/Exercises/Exercises.csproj b/Exercises/Exercises/Exercises.csproj
@@ -1,9 +1,7 @@
 ﻿<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>netstandard2.1</TargetFramework>
     </PropertyGroup>
 
 </Project>
diff --git a/Exercises/ExercisesTests/ExercisesTests.csproj b/Exercises/ExercisesTests/ExercisesTests.csproj
@@ -1,9 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
+        <TargetFramework>net10.0</TargetFramework>
 
         <IsPackable>false</IsPackable>
         <IsTestProject>true</IsTestProject>
diff --git a/README.md b/README.md
@@ -0,0 +1,35 @@
+RudiRonsoni - C# Data Structures and Algorithms
+
+This repository contains implementations, exercises, tests, and benchmarks for common data structures and algorithms.
+
+Quick start
+
+- Restore dependencies:
+
+```bash
+dotnet restore
+```
+
+- Build:
+
+```bash
+dotnet build
+```
+
+- Run tests:
+
+```bash
+dotnet test
+```
+
+Project layout
+
+- `DSA/Algorithms` - algorithm library (libraries target `netstandard2.1`)
+- `DSA/DataStructures` - data structure implementations
+- `Exercises` - exercise implementations and demos
+- `*Benchmarks` - runnable benchmark projects (target `net10`)
+- `*Tests` - test projects (target `net10`)
+
+Namespace convention
+
+All namespaces are prefixed with `RudiRonsoni` and organized by feature (e.g., `RudiRonsoni.Algorithms.Sorting`, `RudiRonsoni.DataStructures.Trees`, `RudiRonsoni.Exercises.Arrays.Sorting`).
