Updates

.gitattributes

@@ -1,2 +1,9 @@
 * text=auto eol=crlf
 *.sh eol=lf
+*.png filter=lfs diff=lfs merge=lfs -text
+.xrefmap.json filter=lfs diff=lfs merge=lfs -text
+# Use LF for templates files.
+templates/** eol=lf
+
+# VerifyTests
+*.verified.txt text eol=lf working-tree-encoding=UTF-8

.github/ISSUE_TEMPLATE/bug-dotnet.md

@@ -0,0 +1,50 @@
+---
+name: Report a .NET API reference bug
+about: Create a bug report for .NET API reference
+title: '[Bug] .NET API bug'
+labels: bug, dotnet
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. ...
+2. ...
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Context (please complete the following information):**
+- OS: Windows
+- Docfx version: [e.g. 2.59.0]
+- .NET version: [e.g. .NET Framework 472, .NET 6.0]
+
+- `docfx.json` config
+
+```json
+// Paste docfx.json config, remove sensitive info
+```
+
+- Exceptions
+
+```csharp
+// Paste the full exception with stacktrace here, remove sensitive info
+```
+
+- Errors and warnings
+
+```csharp
+// Paste warnings or errors related to this bug here, remove sensitive info
+```
+
+- .NET info
+
+```csharp
+// Paste `dotnet --info` output here
+```
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug-template.md

@@ -0,0 +1,30 @@
+---
+name: Report a template bug
+about: Create a bug report for the docfx site template
+title: '[Bug] Template bug'
+labels: bug, template
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Context (please complete the following information):**
+- Browser: [e.g. chrome, safari, edge]
+- Form factor: [e.g. desktop, mobile]
+- Docfx version: [e.g. 2.59.0]
+- Template: [e.g. default, statictoc]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,25 @@
+---
+name: Report a bug
+about: Create a general bug report
+title: '[Bug] My bug'
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. ...
+2. ...
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Context (please complete the following information):**
+- OS: Windows
+- Docfx version: [e.g. 2.59.0]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[Feature Request] My awesome feature'
+labels: ''
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/actions/build/action.yml

@@ -0,0 +1,33 @@
+name: build
+description: build the project
+runs:
+  using: "composite"
+  steps:
+  - uses: actions/setup-node@v6
+    with:
+      node-version: 24
+
+  - uses: actions/setup-dotnet@v5
+    with:
+      dotnet-version: |
+        10.x
+        9.x
+        8.x
+
+  - name: Install fonts-noto-color-emoji package (Linux only)
+    if: runner.os == 'Linux'
+    shell: bash
+    run: |
+      sudo apt-get update
+      sudo apt-get install -y fonts-noto-color-emoji
+
+  - run: npm ci
+    shell: bash
+    working-directory: templates
+
+  - run: npm run build
+    shell: bash
+    working-directory: templates
+
+  - run: dotnet build -c Release --warnAsError --maxcpucount --binaryLogger
+    shell: bash

.github/codecov.yml

@@ -0,0 +1,11 @@
+coverage:
+  status:
+    project:
+      default:
+        informational: true
+    patch:
+      default:
+        informational: true
+comment: false
+github_checks:
+  annotations: false

.github/dependabot.yml

@@ -1,10 +1,52 @@
 version: 2
 updates:
 - package-ecosystem: nuget
-  target-branch: v3
+  target-branch: main
   directory: "/"
   schedule:
-    interval: weekly
+    interval: daily
+  groups:
+    roslyn:
+      patterns:
+      - "Microsoft.CodeAnalysis"
+      - "Microsoft.CodeAnalysis.*"
+    spectre:
+      patterns:
+      - "Spectre.Console"
+      - "Spectre.Console.*"
+    xunit:
+      patterns:
+      - "xunit"
+      - "xunit.*"
+      - "xunit.v3"
+      - "xunit.v3.*"
+
+  - package-ecosystem: "nuget"
+    target-branch: main
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    allow:
+      - dependency-name: "Verify.*"
+
+- package-ecosystem: npm
+  target-branch: main
+  directory: "/templates"
+  schedule:
+    interval: daily
+  cooldown:
+    default-days: 14
+  groups:
+    typescript-eslint:
+      patterns:
+      - "@typescript-eslint/*"
   ignore:
-  - dependency-name: docs.validation
-  - dependency-name: docs.validation.analyzer
+     # Ignore default template dependency update due to missing tests
+  - dependency-name: '@default/*'
+  - dependency-name: 'jquery'
+
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule: 
+    interval: daily
+  target-branch: main

.github/release.yml

@@ -0,0 +1,28 @@
+changelog:
+  exclude:
+    labels:
+      - ignore-for-release
+    authors:
+      - dependabot
+  categories:
+    - title: 💥 Breaking Changes
+      labels:
+        - breaking-change
+    - title: 🎉 New Features
+      labels:
+        - new-feature
+    - title: 🐞 Bug Fixes
+      labels:
+        - bug-fix
+    - title: 🚀 Performance Improvements
+      labels:
+        - performance
+    - title: 🔧 Engineering
+      labels:
+        - engineering
+    - title: 📄 Documentation
+      labels:
+        - documentation
+    - title: 💪 Other Changes
+      labels:
+        - "*"