diff --git a/README.md b/README.md
index 35cd805d9..3aa3c97b9 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,25 @@ various scenarios, CC0-licensed (public domain) for cut-and-paste, allow you to
 News
 ----
 
+## Transition from master branch to main branch
+
+"master" branch was just the default branch name from git originally, it was not selected
+for lws to have any semantic value in itself.  There's no problem changing it to the more
+universally neutral "main" other than any explicit references spread around over the last
+10 years to "master" breaking, which can be managed.
+
+As a first step, I updated my push scripts, that keep libwebsockets.org git and the github
+mirror in sync, to push stuff on "master" also to "main" branch to establish it.  If you
+currently refer to "master" branch in lws for build or CI, you should switch to using
+"main".
+
+For the next months the two should run in parallel and I'll move over references to
+"master" in lws docs to use "main", eventually some point after the next release,
+master will be deleted.
+
+In github, I changed its default branch for libwebsockets to "main", since main and
+master are updated in lockstep currently, this should hopefully have limited impact.
+
 ## v4.1.0 and v4.1-stable are released
 
 See the [changelog](https://libwebsockets.org/git/libwebsockets/tree/changelog), summary