diff --git a/.changelog/2706.trivial.md b/.changelog/2706.trivial.md
new file mode 100644
index 00000000000..db5f1bbc486
--- /dev/null
+++ b/.changelog/2706.trivial.md
@@ -0,0 +1 @@
+readme: Avoid tricky parsing of hard wrapped link
diff --git a/Makefile b/Makefile
index 6b60ed0cd9a..5df0e227ba1 100644
--- a/Makefile
+++ b/Makefile
@@ -66,10 +66,12 @@ lint-targets := lint-go lint-git lint-md lint-changelog
 lint-go:
 	@$(MAKE) -C go lint
 
+# NOTE: gitlint internally uses git rev-list, where A..B is asymmetric difference, which is kind of the opposite of
+# how git diff interprets A..B vs A...B.
 lint-git: fetch-git
 	@COMMIT_SHA=`git rev-parse $(OASIS_CORE_GIT_ORIGIN_REMOTE)/$(RELEASE_BRANCH)` && \
 	echo "Running gitlint for commits from $(OASIS_CORE_GIT_ORIGIN_REMOTE)/$(RELEASE_BRANCH) ($${COMMIT_SHA:0:7})..."; \
-	gitlint --commits $(OASIS_CORE_GIT_ORIGIN_REMOTE)/$(RELEASE_BRANCH)...HEAD
+	gitlint --commits $(OASIS_CORE_GIT_ORIGIN_REMOTE)/$(RELEASE_BRANCH)..HEAD
 
 lint-md:
 	@npx markdownlint-cli '**/*.md' --ignore .changelog/
diff --git a/README.md b/README.md
index b0a60b9151a..2ddfa22c810 100644
--- a/README.md
+++ b/README.md
@@ -50,8 +50,8 @@ Prerequisites:
 
 * Linux (if you are not on Linux, you will need to either set up a VM with the
   proper environment or, if Docker is available for your platform, use the
-  provided Docker image which does this for you, [see below](
-  #using-the-development-docker-image)).
+  provided Docker image which does this for you,
+  [see below](#using-the-development-docker-image)).
 
 * System packages:
   * [Bubblewrap](https://github.com/projectatomic/bubblewrap) (at least version