Improve README

diff --git a/README.md b/README.md
index cba01ad2d6acfbcb7ee1138d23304f9b2ba26993..1747b8935d48a4fff57da350f47153ad9e67b4e3 100644 (file)
--- a/README.md
+++ b/README.md
@@ -64,3 +64,37 @@ A shortcut is provided (which requires the dependent packages to be installed lo
 
        cd sources/whisper.cpp
        ../build.dev
+
+### Update upstream
+(Using `ggml` as an example, the same approach applies to the other layers)
+
+In a given layer git repository, make sure the upstream git repository is registered as remote:
+
+       cd sources/ggmll
+       git remote add github https://github.com/ggml-org/ggml.git
+
+Fetch new commits from upstreams's `main` branch, and merge them to the `upstream/latest` branch.
+
+       git fetch github main
+       git checkout upstream/latest
+       git merge --ff-only github/master
+
+Check out the commit you are interested in and count revisions in order to create a versioned tag:
+
+       git checkout 9a4acb374565f4146b8d6eb1cffdcd7d437d1ba2
+       # ggml or llama.cpp
+       git tag upstream/0.0.$(git rev-list --count HEAD)
+       # whisper.cpp
+       # git tag upstream/1.7.4+$(git rev-list --count v1.7.4..HEAD)
+
+### New package release
+After updating upstream, checkout `debian/latest` and merge from upstream tag:
+
+       git checkout debian/latest
+       git merge upstream/0.0.1722
+
+Edit `debian/changelog` and perform packaging-specific changes.
+
+Test the build locally:
+
+       ../build-pbuilder bookworm amd64