Merge build and deploy into one job

Author: pekkah

.github/workflows/docs.yml

@@ -22,7 +22,7 @@ env:
 jobs:
   build-and-deploy:
     runs-on: ubuntu-latest
-    concurrency: ci-${{ github.ref }}
+    concurrency: docs-${{ github.ref }}
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Tanka Documentation Generator is a .NET 9.0 console application that generates static HTML documentation sites from Markdown files. It's packaged as a .NET Global Tool (`Tanka.DocsGen`) and provides advanced features like live C# code integration via Roslyn and multi-source content aggregation.
+Tanka Documentation Generator is a .NET 9.0 console application that generates static HTML documentation sites from Markdown files. It's distributed as a .NET Global Tool (`Tanka.DocsGen`) that can be installed via `dotnet tool install --global Tanka.DocsGen`. It provides advanced features like live C# code integration via Roslyn and multi-source content aggregation.
 
 ## Common Development Commands
 
@@ -32,12 +32,13 @@ dotnet run --project ./src/DocsTool/ -- dev -f ./tanka-docs-wip.yml
 dotnet run --project ./src/DocsTool/ -- build -f ./tanka-docs-wip.yml
 ```
 
-### Tool Development and Testing
+### Tool Installation and Testing
 ```bash
-# Build and pack the global tool
-dotnet pack -c Release -o ./artifacts
+# Install from NuGet (primary method)
+dotnet tool install --global Tanka.DocsGen
 
-# Install tool locally for testing
+# Or build and pack the global tool locally for development
+dotnet pack -c Release -o ./artifacts
 dotnet tool install --global --add-source ./artifacts Tanka.DocsGen
 
 # Test the installed tool

README.md

@@ -18,17 +18,15 @@ Tanka Docs is a powerful technical documentation generator designed for .NET pro
 
 ### 1. Install
 
-**Note:** Tanka.DocsGen is currently distributed as source code. To install:
+Install Tanka Docs as a .NET global tool:
 
 ```bash
-# Clone the repository
+# Install from NuGet (recommended)
+dotnet tool install --global Tanka.DocsGen
+
+# Or install from local source (for development)
 git clone https://github.com/pekkah/tanka-docs-gen.git
 cd tanka-docs-gen
-
-# Build the tool
-dotnet build
-
-# Install as global tool (optional)
 dotnet pack -c Release -o ./artifacts
 dotnet tool install --global --add-source ./artifacts Tanka.DocsGen
 ```

docs-v2/01-getting-started/getting-started.md

@@ -12,24 +12,26 @@ This guide will walk you through setting up your first Tanka Docs project from s
 - **Git** (Tanka Docs sources content from Git repositories)
 - **Text editor** or IDE of your choice
 
-## Step 1: Clone the Project
+## Step 1: Install Tanka Docs
 
-Tanka Docs is currently distributed as source code. Clone the repository:
+Install Tanka Docs as a .NET global tool:
 
 ```bash
-git clone https://github.com/pekkah/tanka-docs-gen.git
-cd tanka-docs-gen
+# Install from NuGet (recommended)
+dotnet tool install --global Tanka.DocsGen
 ```
 
-## Step 2: Build the Tool
-
-Build the Tanka Docs tool:
+**Alternative installation from source:**
 
 ```bash
-dotnet build
+# Clone and build from source (for development)
+git clone https://github.com/pekkah/tanka-docs-gen.git
+cd tanka-docs-gen
+dotnet pack -c Release -o ./artifacts
+dotnet tool install --global --add-source ./artifacts Tanka.DocsGen
 ```
 
-## Step 3: Create Your Documentation Project
+## Step 2: Create Your Documentation Project
 
 Create a new directory for your documentation project:
 
@@ -39,7 +41,7 @@ cd my-docs-project
 git init -b main
 ```
 
-## Step 4: Create the Main Configuration File
+## Step 3: Create the Main Configuration File
 
 Create `tanka-docs.yml` in your project root. This file defines your site structure and content sources:
 
@@ -66,7 +68,7 @@ branches:
 - `branches`: Git branches/refs to source content from
 - `input_path`: Directories to include from each branch
 
-## Step 5: Create Documentation Sections
+## Step 4: Create Documentation Sections
 
 Tanka Docs organizes content into sections. Create your main documentation section:
 
@@ -94,7 +96,7 @@ includes:
 - `nav`: Navigation file(s) for this section
 - `includes`: File patterns to include in this section
 
-## Step 6: Create Content Files
+## Step 5: Create Content Files
 
 ### Main Index Page
 
@@ -177,7 +179,7 @@ your-command --version
 
 Create additional pages (`docs/configuration.md`, `docs/advanced.md`) following the same pattern.
 
-## Step 7: Add Shared Content (Optional)
+## Step 6: Add Shared Content (Optional)
 
 Create a partials section for shared content:
 

docs-v2/04-advanced/cli-reference.md

@@ -8,29 +8,32 @@ Tanka Docs provides a command-line interface (CLI) that allows you to build and
 
 ## Installation
 
-**Note:** Tanka.DocsGen is currently distributed as source code. To install:
+Install Tanka Docs as a .NET global tool:
 
 ```bash
-# Clone the repository
-git clone https://github.com/pekkah/tanka-docs-gen.git
-cd tanka-docs-gen
+# Install from NuGet (recommended)
+dotnet tool install --global Tanka.DocsGen
+```
 
-# Build the tool
-dotnet build
+**Alternative installation from source (for development):**
 
-# Install as global tool (optional)
+```bash
+# Clone and build from source
+git clone https://github.com/pekkah/tanka-docs-gen.git
+cd tanka-docs-gen
 dotnet pack -c Release -o ./artifacts
 dotnet tool install --global --add-source ./artifacts Tanka.DocsGen
 ```
 
 To update to the latest version:
 
 ```bash
-# Pull latest changes and rebuild
-git pull
-dotnet build
+# Update from NuGet
+dotnet tool update --global Tanka.DocsGen
 
-# Update global tool (if installed)
+# Or update from source (if installed from source)
+git pull
+dotnet pack -c Release -o ./artifacts
 dotnet tool update --global --add-source ./artifacts Tanka.DocsGen
 ```