From 19187aa604a12171541a303bacd1dea275e7f441 Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Mon, 9 Mar 2026 09:19:35 -0600
Subject: [PATCH 1/5] Update docs to explain about zero-similarity pairs

---
 R/pairwise_similarity.R | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/R/pairwise_similarity.R b/R/pairwise_similarity.R
index 5f322cc..71d95a8 100644
--- a/R/pairwise_similarity.R
+++ b/R/pairwise_similarity.R
@@ -2,6 +2,12 @@
 #'
 #' Compute cosine similarity of all pairs of items in a tidy table.
 #'
+#' @details
+#' This function uses sparse matrices internally for efficiency, which means
+#' pairs with zero similarity are excluded from the output. To include
+#' zero-similarity pairs, use [tidyr::complete()] on your result:
+#' `complete(item1, item2, fill = list(similarity = 0))`.
+#'
 #' @param tbl Table
 #' @param item Item to compare; will end up in `item1` and
 #' `item2` columns

From 4555ad81b8f4fbbe1b119f786a8c505dbb850b2d Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Mon, 9 Mar 2026 09:19:43 -0600
Subject: [PATCH 2/5] Redocument

---
 DESCRIPTION                | 2 +-
 man/pairwise_similarity.Rd | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 7c26558..eb32ab6 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -47,4 +47,4 @@ VignetteBuilder:
 Encoding: UTF-8
 LazyData: TRUE
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.2.1
+RoxygenNote: 7.3.3
diff --git a/man/pairwise_similarity.Rd b/man/pairwise_similarity.Rd
index 524d684..9c93b73 100644
--- a/man/pairwise_similarity.Rd
+++ b/man/pairwise_similarity.Rd
@@ -25,6 +25,12 @@ such as \code{diag} and \code{upper}}
 \description{
 Compute cosine similarity of all pairs of items in a tidy table.
 }
+\details{
+This function uses sparse matrices internally for efficiency, which means
+pairs with zero similarity are excluded from the output. To include
+zero-similarity pairs, use \code{\link[tidyr:complete]{tidyr::complete()}} on your result:
+\code{complete(item1, item2, fill = list(similarity = 0))}.
+}
 \examples{
 
 library(janeaustenr)

From 6ca4be300d290aa42bf9ad515ff37ac490b0cc73 Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Mon, 9 Mar 2026 09:26:42 -0600
Subject: [PATCH 3/5] Update GH action for ggrepel requiring R 4.5

---
 .github/workflows/R-CMD-check.yaml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/R-CMD-check.yaml b/.github/workflows/R-CMD-check.yaml
index 52c2b27..b81d064 100644
--- a/.github/workflows/R-CMD-check.yaml
+++ b/.github/workflows/R-CMD-check.yaml
@@ -41,9 +41,13 @@ jobs:
 
       - uses: r-lib/actions/setup-r-dependencies@v2
         with:
-          extra-packages: any::rcmdcheck
+          extra-packages: |
+            any::rcmdcheck
+            ggraph=?ignore-before-r=4.5.0
           needs: check
 
       - uses: r-lib/actions/check-r-package@v2
         with:
           upload-snapshots: true
+        env:
+          _R_CHECK_FORCE_SUGGESTS_: false

From 312e81c70e8dd8cf201ee3ccda7a157826c0be65 Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Mon, 9 Mar 2026 09:59:21 -0600
Subject: [PATCH 4/5] Update NEWS

---
 NEWS.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/NEWS.md b/NEWS.md
index 79050b7..75b502f 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,6 +1,7 @@
 # widyr (development version)
 
 * Now force evaluation for `widely()` function factory (thanks to @lhdjung, #44)
+* Explain how to handle zero-similarity pairs in `pairwise_similarity()` (#47)
 
 # widyr 0.1.5
 

From 92c53f720bb03f60729f2d581eb97a4190ac7278 Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Mon, 9 Mar 2026 09:59:34 -0600
Subject: [PATCH 5/5] Bump GH action versions

---
 .github/workflows/R-CMD-check.yaml   | 2 +-
 .github/workflows/pkgdown.yaml       | 4 ++--
 .github/workflows/test-coverage.yaml | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/R-CMD-check.yaml b/.github/workflows/R-CMD-check.yaml
index b81d064..d295d9e 100644
--- a/.github/workflows/R-CMD-check.yaml
+++ b/.github/workflows/R-CMD-check.yaml
@@ -29,7 +29,7 @@ jobs:
       R_KEEP_PKG_SOURCE: yes
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - uses: r-lib/actions/setup-pandoc@v2
 
diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml
index 0b26021..94604d4 100644
--- a/.github/workflows/pkgdown.yaml
+++ b/.github/workflows/pkgdown.yaml
@@ -20,7 +20,7 @@ jobs:
     env:
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - uses: r-lib/actions/setup-pandoc@v2
 
@@ -39,7 +39,7 @@ jobs:
 
       - name: Deploy to GitHub pages 🚀
         if: github.event_name != 'pull_request'
-        uses: JamesIves/github-pages-deploy-action@4.1.4
+        uses: JamesIves/github-pages-deploy-action@v4
         with:
           clean: false
           branch: gh-pages
diff --git a/.github/workflows/test-coverage.yaml b/.github/workflows/test-coverage.yaml
index 4b65418..d9d5c3d 100644
--- a/.github/workflows/test-coverage.yaml
+++ b/.github/workflows/test-coverage.yaml
@@ -15,7 +15,7 @@ jobs:
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - uses: r-lib/actions/setup-r@v2
         with: