docs: all

Author: somaz94

docs/AUTHENTICATION.md

@@ -84,21 +84,23 @@ github_token: ${{ secrets.PAT_TOKEN }}
 ### Scenario 1: Simple Commit and Push
 
 ```yaml
-- uses: actions/checkout@v5
+- uses: actions/checkout@v6
+  with:
+    token: ${{ secrets.GITHUB_TOKEN }}
 
 - uses: somaz94/go-git-commit-action@v1
   with:
     user_email: actions@github.com
     user_name: GitHub Actions
-    # github_token not required for checkout@v5
+    github_token: ${{ secrets.GITHUB_TOKEN }}  # Required for checkout@v6
 ```
 
 <br/>
 
 ### Scenario 2: Tag Operations
 
 ```yaml
-- uses: actions/checkout@v5
+- uses: actions/checkout@v6
   with:
     token: ${{ secrets.PAT_TOKEN }}  # PAT required for tags
 
@@ -107,14 +109,17 @@ github_token: ${{ secrets.PAT_TOKEN }}
     user_email: actions@github.com
     user_name: GitHub Actions
     tag_name: v1.0.0
+    github_token: ${{ secrets.PAT_TOKEN }}
 ```
 
 <br/>
 
 ### Scenario 3: Pull Request Creation
 
 ```yaml
-- uses: actions/checkout@v5
+- uses: actions/checkout@v6
+  with:
+    token: ${{ secrets.GITHUB_TOKEN }}
 
 - uses: somaz94/go-git-commit-action@v1
   with:

docs/DEVELOPMENT.md

@@ -37,8 +37,12 @@ Guide for developers who want to contribute to or modify the Go Git Commit Actio
 │   │   ├── common.go
 │   │   ├── common_test.go
 │   │   ├── file_operations.go
-│   │   ├── pr.go
-│   │   └── tag.go
+│   │   ├── pr.go               # PR orchestration
+│   │   ├── tag.go
+│   │   └── pr/                 # PR modules
+│   │       ├── branch.go       # Branch management
+│   │       ├── creation.go     # PR creation & API
+│   │       └── diff.go         # Change detection
 │   └── gitcmd/                 # Git command builders
 │       ├── commands.go
 │       └── commands_test.go
@@ -241,9 +245,14 @@ This reduces image size and build time.
 - Interface for dependency injection
 
 **internal/git**
-- Git operations (commit, PR, tag)
+- Git operations (commit, tag)
 - File operations
-- Branch management
+- PR orchestration
+
+**internal/git/pr**
+- Branch management (`branch.go`)
+- PR creation and GitHub API (`creation.go`)
+- Change detection (`diff.go`)
 
 **internal/gitcmd**
 - Git command building

docs/EXAMPLES.md

@@ -47,6 +47,7 @@ jobs:
           branch: main
           repository_path: path/to/repo  # Optional
           file_pattern: '*.md'             # Example: commit only markdown files
+          github_token: ${{ secrets.GITHUB_TOKEN }}
 ```
 
 ---
@@ -81,6 +82,7 @@ jobs:
           user_name: GitHub Actions
           tag_name: v1.0.0
           tag_message: Release version 1.0.0  # Optional for annotated tags
+          github_token: ${{ secrets.PAT_TOKEN }}
 ```
 
 <br/>
@@ -109,6 +111,7 @@ jobs:
           user_name: GitHub Actions
           tag_name: v1.0.0
           delete_tag: true
+          github_token: ${{ secrets.PAT_TOKEN }}
 ```
 
 <br/>
@@ -138,6 +141,7 @@ jobs:
           user_name: GitHub Actions
           tag_name: v1
           tag_reference: ${{ github.sha }}
+          github_token: ${{ secrets.PAT_TOKEN }}
 
       # Tag from another tag
       - name: Create Git Tag from Tag
@@ -147,6 +151,7 @@ jobs:
           user_name: GitHub Actions
           tag_name: latest
           tag_reference: v1.0.2
+          github_token: ${{ secrets.PAT_TOKEN }}
 
       # Tag from branch
       - name: Create Git Tag from Branch
@@ -156,6 +161,7 @@ jobs:
           user_name: GitHub Actions
           tag_name: stable
           tag_reference: main
+          github_token: ${{ secrets.PAT_TOKEN }}
 ```
 
 ---
@@ -307,6 +313,7 @@ Commit multiple file types:
     commit_message: "chore: update multiple file types"
     branch: main
     file_pattern: "docs/*.md src/*.go *.yaml"
+    github_token: ${{ secrets.GITHUB_TOKEN }}
 ```
 
 <br/>
@@ -322,4 +329,5 @@ Commit multiple file types:
     branch: main
     repository_path: "."
     file_pattern: "config/*.yaml docs/*.md src/util/*.js"
+    github_token: ${{ secrets.GITHUB_TOKEN }}
 ```