astar-development · jaybarden1 · Aug 13, 2025 · Aug 13, 2025
diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
@@ -1,4 +1,4 @@
-name: SonarQube
+name: Build and analyse with SonarQube
 
 on:
   push:
@@ -13,6 +13,8 @@ jobs:
   build:
     name: Build and analyze
     runs-on: windows-latest
+    permissions:
+      contents: read
 
     steps:
       - name: Set up JDK 17

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -6,6 +6,8 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     env:
       ProjectName: 'AStar.Dev.Functional.Extensions'
 

diff --git a/AStar.Dev.Functional.Extensions.sln b/AStar.Dev.Functional.Extensions.sln
@@ -16,6 +16,25 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{D1A87C44-FB0
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{0A5D570A-ACDC-429C-A9EA-9E8D9DA7774C}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{16259E77-6EBB-4B17-94EF-AF149059D5D8}"
+	ProjectSection(SolutionItems) = preProject
+		Readme.md = Readme.md
+		Readme-result.md = Readme-result.md
+		Readme-option.md = Readme-option.md
+		blog-post.md = blog-post.md
+	EndProjectSection
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Docs", "Docs", "{211253BB-7DA6-4078-8105-61B7A58ABB35}"
+	ProjectSection(SolutionItems) = preProject
+		docs\advanced-usage-option.md = docs\advanced-usage-option.md
+		docs\advanced-usage.md = docs\advanced-usage.md
+		docs\basic-usage.md = docs\basic-usage.md
+		docs\core-concepts.md = docs\core-concepts.md
+		docs\error-handling-patterns.md = docs\error-handling-patterns.md
+		docs\method-reference.md = docs\method-reference.md
+		docs\testing.md = docs\testing.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -35,5 +54,6 @@ Global
 		{2C3EC910-77D3-475C-A9EE-E8F9F9C8C43C} = {267BE110-D583-4557-80D5-0D9E80A05542}
 		{46743FC5-9AAD-46A0-BD96-B2EEA6CE9E23} = {D1A87C44-FB04-49D8-8C34-C6CD33944612}
 		{CD5D55C2-C6D1-4E28-93FD-1A60118403CE} = {0A5D570A-ACDC-429C-A9EA-9E8D9DA7774C}
+		{211253BB-7DA6-4078-8105-61B7A58ABB35} = {16259E77-6EBB-4B17-94EF-AF149059D5D8}
 	EndGlobalSection
 EndGlobal
diff --git a/...ev.Functional.Extensions/Readme-option.md → Readme-option.md b/...ev.Functional.Extensions/Readme-option.md → Readme-option.md
@@ -22,14 +22,10 @@ patterns in C#.
 
 ### 🏗️ Structure
 
-encapsulates either: `Option<T>`
+`Option<T>` encapsulates either:
 
 - ✅ `Some(T)` — a present value
-- ❌ — the absence of a value `None`
-  t
-  t
-  t
-  t
+- ❌ `None` — the absence of a value
 
 ``` csharp
 // Create a Some option
@@ -229,3 +225,5 @@ public Option<BookReservation> ReserveBookWithLogging(string isbn, int quantity)
         });
 }
 ```
+
+Want more? Some additional documentation can be found [here](docs/advanced-usage-option.md) - focusing on async method usage.
diff --git a/...ev.Functional.Extensions/Readme-result.md → Readme-result.md b/...ev.Functional.Extensions/Readme-result.md → Readme-result.md
diff --git a/...AStar.Dev.Functional.Extensions/Readme.md → Readme.md b/...AStar.Dev.Functional.Extensions/Readme.md → Readme.md
@@ -12,6 +12,8 @@ Full details can be found [here](Readme-result.md)
 
 Full details can be found [here](Readme-option.md)
 
+In addition, there is a [blog post](blog-post.md) that, depending on when you see this, should have been published to this new-fangled t'interweb-thing...
+
 ## Build and analysis
 
 ### GitHub build

diff --git a/...ar.Dev.Functional.Extensions/blog-post.md → blog-post.md b/...ar.Dev.Functional.Extensions/blog-post.md → blog-post.md
diff --git a/....Extensions/docs/advanced-usage-option.md → docs/advanced-usage-option.md b/....Extensions/docs/advanced-usage-option.md → docs/advanced-usage-option.md
diff --git a/...ctional.Extensions/docs/advanced-usage.md → docs/advanced-usage.md b/...ctional.Extensions/docs/advanced-usage.md → docs/advanced-usage.md
diff --git a/...Functional.Extensions/docs/basic-usage.md → docs/basic-usage.md b/...Functional.Extensions/docs/basic-usage.md → docs/basic-usage.md
diff --git a/...nctional.Extensions/docs/core-concepts.md → docs/core-concepts.md b/...nctional.Extensions/docs/core-concepts.md → docs/core-concepts.md
diff --git a/...xtensions/docs/error-handling-patterns.md → docs/error-handling-patterns.md b/...xtensions/docs/error-handling-patterns.md → docs/error-handling-patterns.md
diff --git a/...ional.Extensions/docs/method-reference.md → docs/method-reference.md b/...ional.Extensions/docs/method-reference.md → docs/method-reference.md
diff --git a/...Dev.Functional.Extensions/docs/testing.md → docs/testing.md b/...Dev.Functional.Extensions/docs/testing.md → docs/testing.md
diff --git a/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.csproj b/src/AStar.Dev.Functional.Extensions/AStar.Dev.Functional.Extensions.csproj
@@ -9,9 +9,9 @@
         <IncludeSymbols>true</IncludeSymbols>
         <SymbolPackageFormat>snupkg</SymbolPackageFormat>
         <PackageId>AStar.Dev.Functional.Extensions</PackageId>
-        <Version>0.3.0-alpha</Version>
+        <Version>0.3.1-alpha</Version>
         <PackageReadmeFile>Readme.md</PackageReadmeFile>
-        <Authors>Jason</Authors>
+        <Authors>AStar Development, Jason Barden</Authors>
         <Company>AStar Development</Company>
         <Description>F#-inspired Result type with functional combinators, async support, and LINQ integration.</Description>
         <PackageTags>result functional monad async linq</PackageTags>