From cb14cf9bd47d3b13a2ec07872ee85d98ebb4a9a9 Mon Sep 17 00:00:00 2001
From: Slim B <slim.b.pro@gmail.com>
Date: Fri, 13 Feb 2026 18:38:44 +0300
Subject: [PATCH] Add docs for updating josh-sync version in Nix devenv

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 docs/guide.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/guide.md b/docs/guide.md
index f3c16c2..2a7349c 100644
--- a/docs/guide.md
+++ b/docs/guide.md
@@ -165,6 +165,34 @@ SUBREPO_SSH_KEY="-----BEGIN OPENSSH PRIVATE KEY-----
 # AUTH_REPO_TOKEN=<auth-specific-token>
 ```
 
+### Updating josh-sync in devenv
+
+To update to the latest version:
+
+```bash
+devenv update josh-sync
+```
+
+Or with plain Nix flakes:
+
+```bash
+nix flake lock --update-input josh-sync
+```
+
+To pin to a specific version, use a tag ref in `devenv.yaml`:
+
+```yaml
+josh-sync:
+  url: git+https://your-gitea.example.com/org/josh-sync?ref=v1.1
+  flake: true
+```
+
+After updating, verify the version:
+
+```bash
+josh-sync --version
+```
+
 ### Option B: Manual installation
 
 Install the required tools, then either: