diff --git a/lib/asciidoctor/chat-block-processor/README.adoc b/lib/asciidoctor/chat-block-processor/README.adoc
index fd1653e..d4dd357 100644
--- a/lib/asciidoctor/chat-block-processor/README.adoc
+++ b/lib/asciidoctor/chat-block-processor/README.adoc
@@ -102,4 +102,14 @@ Hello there!
 ....
 
 - The following block should contain El Pablo's melodramatic dialog state.
-Take note
+Take note of the resulting path for the image which is in kebab-case.
++
+....
+[chat, El Pablo, state=melodramatic]
+====
+What tragedy is happening here!
+I couldn't take it.
+
+__Please__.
+====
+....
diff --git a/lib/asciidoctor/git-blob-include-processor/README.adoc b/lib/asciidoctor/git-blob-include-processor/README.adoc
index 2fc2dd7..ca5718b 100644
--- a/lib/asciidoctor/git-blob-include-processor/README.adoc
+++ b/lib/asciidoctor/git-blob-include-processor/README.adoc
@@ -47,6 +47,7 @@ The extension is composed of two parts: an include processor and a preprocessor.
 The preprocessor add a document attribute, `doccontentref`, which it gives the Git reference for that content.
 `doccontentref` is the difference between the process working directory (`Dir.pwd`) and the base directory of the content to be converted.
 In case the process working directory is not entirely consistent for several reasons, you could give the attribute `rootdir` as the basis for the comparison.
+As another option, you could also manually set `doccontentref` in case it isn't applicable (i.e., for multilingual sites in Hugo projects).
 
 The include processor also accepts an empty target with the prefix (i.e., `include::git:[]`) as a shorthand for `include::git:{doccontentref}`.
 
diff --git a/lib/asciidoctor/gitlab-raw-content-include-processor/README.adoc b/lib/asciidoctor/gitlab-raw-content-include-processor/README.adoc
index 8f84a26..5cdc7e4 100644
--- a/lib/asciidoctor/gitlab-raw-content-include-processor/README.adoc
+++ b/lib/asciidoctor/gitlab-raw-content-include-processor/README.adoc
@@ -37,4 +37,8 @@ By default, it uses version `v4`.
 
 == Example usage
 
-- `include::gitlab:gitlab-org/gitlab[rev=master, path=README.md]` should
+- `include::gitlab:gitlab-org/gitlab[rev=master, path=README.md]` should include the README content from the master branch of link:https://gitlab.com/gitlab-org/gitlab/[GitLab source code].
+
+- `include::freedesktop-sdk/freedesktop-sdk[rev=bcb3e0de957519e87a4c7b8c0e40af9876e531e7, path=.gitlab-ci.yml]` should transclude the GitLab CI configuration from link:https://gitlab.com/freedesktop-sdk/freedesktop-sdk[Freedesktop SDK].
+
+- `include::World/warp[domain=gitlab.gnome.org, rev=v0.5.2, path=meson_options.txt]` includes `meson_options.txt` from link:https://gitlab.gnome.org/World/warp/[Warp source code] at v0.5.2.