Normalize CRLF line endings in docs

Author: Codex

README.md

@@ -72,12 +72,12 @@ After setup, open Grafana at **http://localhost:3002** (admin / admin). DORA and
 
 Four concepts to understand — then every command makes sense:
 
-| Concept | What It Is |
-|---------|-----------|
-| **Connection** | An authenticated link to a data source (GitHub, Copilot, Jenkins). Each gets its own PAT/credentials. |
-| **Scope** | *What* to collect — specific repos for GitHub, an org/enterprise for Copilot, jobs for Jenkins. |
-| **Project** | Groups connections + scopes into a single view with DORA metrics enabled. |
-| **Blueprint** | The sync schedule (cron). Created automatically with the project. |
+| Concept | What It Is |
+|---------|-----------|
+| **Connection** | An authenticated link to a data source (GitHub, Copilot, Jenkins). Each gets its own PAT/credentials. |
+| **Scope** | *What* to collect — specific repos for GitHub, an org/enterprise for Copilot, jobs for Jenkins. |
+| **Project** | Groups connections + scopes into a single view with DORA metrics enabled. |
+| **Blueprint** | The sync schedule (cron). Created automatically with the project. |
 
 <!-- SCREENSHOT: Config UI project page showing connections → scopes → project hierarchy -->
 
@@ -117,12 +117,12 @@ The CLI will prompt you for your PAT. You can also pass `--token`, use an `--env
 # GitHub (repos, PRs, workflows, deployments)
 gh devlake configure connection add --plugin github --org my-org
 
-# Copilot (usage metrics, seats, acceptance rates)
-gh devlake configure connection add --plugin gh-copilot --org my-org
-
-# Jenkins (jobs and build data for DORA)
-gh devlake configure connection add --plugin jenkins --endpoint https://jenkins.example.com --username admin --token myapitoken
-```
+# Copilot (usage metrics, seats, acceptance rates)
+gh devlake configure connection add --plugin gh-copilot --org my-org
+
+# Jenkins (jobs and build data for DORA)
+gh devlake configure connection add --plugin jenkins --endpoint https://jenkins.example.com --username admin --token myapitoken
+```
 
 The CLI tests each connection before saving. On success:
 
@@ -142,12 +142,12 @@ Tell DevLake which repos or orgs to collect from:
 # GitHub — pick repos interactively, or pass --repos explicitly
 gh devlake configure scope add --plugin github --org my-org
 
-# Copilot — org-level metrics
-gh devlake configure scope add --plugin gh-copilot --org my-org
-
-# Jenkins — pick jobs interactively (or pass --jobs)
-gh devlake configure scope add --plugin jenkins --org my-org
-```
+# Copilot — org-level metrics
+gh devlake configure scope add --plugin gh-copilot --org my-org
+
+# Jenkins — pick jobs interactively (or pass --jobs)
+gh devlake configure scope add --plugin jenkins --org my-org
+```
 
 DORA patterns (deployment workflow, production environment, incident label) use sensible defaults. See [docs/configure-scope.md](docs/configure-scope.md) for overrides.
 
@@ -188,14 +188,14 @@ For the full guide, see [Day-2 Operations](docs/day-2.md).
 
 ## Supported Plugins
 
-| Plugin | Status | What It Collects | Required PAT scopes |
-|--------|--------|------------------|---------------------|
-| GitHub | ✅ Available | Repos, PRs, issues, workflows, deployments (DORA) | `repo`, `read:org`, `read:user` |
-| GitHub Copilot | ✅ Available | Usage metrics, seats, acceptance rates | `manage_billing:copilot`, `read:org` (+ `read:enterprise` for enterprise metrics) |
-| Jenkins | ✅ Available | Jobs, builds, deployments (DORA) | Username + API token/password |
-| Jira | ✅ Available | Boards, issues, sprints (change lead time, cycle time) | API token (permissions from user account) |
-| Azure DevOps | ✅ Available | Repos, pipelines, deployments (DORA) | PAT with repo and pipeline access |
-| GitLab | ✅ Available | Repos, MRs, pipelines, deployments (DORA) | `read_api`, `read_repository` |
+| Plugin | Status | What It Collects | Required PAT scopes |
+|--------|--------|------------------|---------------------|
+| GitHub | ✅ Available | Repos, PRs, issues, workflows, deployments (DORA) | `repo`, `read:org`, `read:user` |
+| GitHub Copilot | ✅ Available | Usage metrics, seats, acceptance rates | `manage_billing:copilot`, `read:org` (+ `read:enterprise` for enterprise metrics) |
+| Jenkins | ✅ Available | Jobs, builds, deployments (DORA) | Username + API token/password |
+| Jira | ✅ Available | Boards, issues, sprints (change lead time, cycle time) | API token (permissions from user account) |
+| Azure DevOps | ✅ Available | Repos, pipelines, deployments (DORA) | PAT with repo and pipeline access |
+| GitLab | ✅ Available | Repos, MRs, pipelines, deployments (DORA) | `read_api`, `read_repository` |
 
 See [Token Handling](docs/token-handling.md) for env key names and multi-plugin `.devlake.env` examples.
 

docs/token-handling.md

@@ -1,8 +1,8 @@
 # Token Handling
 
-How the CLI resolves, uses, and secures Personal Access Tokens (PATs) for each plugin connection.
-
-Supported today: **GitHub**, **GitHub Copilot**, **GitLab**, **Azure DevOps**.
+How the CLI resolves, uses, and secures Personal Access Tokens (PATs) for each plugin connection.
+
+Supported today: **GitHub**, **GitHub Copilot**, **GitLab**, **Azure DevOps**.
 
 ## Token Resolution Order
 
@@ -29,12 +29,12 @@ AZURE_DEVOPS_PAT=ado_pat_here
 
 The CLI checks **plugin-specific** keys (first match wins):
 
-| Plugin | `.devlake.env` keys (in order) | Environment variables (in order) |
-|--------|-------------------------------|---------------------------------|
-| GitHub | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` |
-| GitHub Copilot | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` |
-| GitLab | `GITLAB_TOKEN`, `GITLAB_PAT` | `GITLAB_TOKEN`, `GITLAB_PAT` |
-| Azure DevOps | `AZURE_DEVOPS_PAT`, `AZDO_PAT` | `AZURE_DEVOPS_PAT`, `AZDO_PAT` |
+| Plugin | `.devlake.env` keys (in order) | Environment variables (in order) |
+|--------|-------------------------------|---------------------------------|
+| GitHub | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` |
+| GitHub Copilot | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` | `GITHUB_PAT`, `GITHUB_TOKEN`, `GH_TOKEN` |
+| GitLab | `GITLAB_TOKEN`, `GITLAB_PAT` | `GITLAB_TOKEN`, `GITLAB_PAT` |
+| Azure DevOps | `AZURE_DEVOPS_PAT`, `AZDO_PAT` | `AZURE_DEVOPS_PAT`, `AZDO_PAT` |
 
 By default, the CLI looks for `.devlake.env` in the current directory. Override the path with `--env-file`:
 
@@ -52,13 +52,13 @@ As a final fallback, the CLI prompts you to paste the token at the terminal. Inp
 
 ## Required PAT Scopes
 
-| Plugin | Required Scopes |
-|--------|----------------|
-| GitHub | `repo`, `read:org`, `read:user` |
-| GitHub Copilot | `manage_billing:copilot`, `read:org` |
-| GitHub Copilot (enterprise) | + `read:enterprise` |
-| GitLab | `read_api`, `read_repository` |
-| Azure DevOps | PAT with repo + pipeline access (no OAuth scopes) |
+| Plugin | Required Scopes |
+|--------|----------------|
+| GitHub | `repo`, `read:org`, `read:user` |
+| GitHub Copilot | `manage_billing:copilot`, `read:org` |
+| GitHub Copilot (enterprise) | + `read:enterprise` |
+| GitLab | `read_api`, `read_repository` |
+| Azure DevOps | PAT with repo + pipeline access (no OAuth scopes) |
 
 The CLI displays required scopes as a reminder before prompting for the token.