diff --git a/common/flatpak-ref.c b/common/flatpak-ref.c
index fd22f5c5..cf4539f1 100644
--- a/common/flatpak-ref.c
+++ b/common/flatpak-ref.c
@@ -29,7 +29,7 @@
  * @Title: FlatpakRef
  * @Short_description: Application reference
  *
- * Currently flatpak manages two types of binary artifacts: applications, and
+ * Currently Flatpak manages two types of binary artifacts: applications, and
  * runtimes. Applications contain a program that desktop users can run, while
  * runtimes contain only libraries and data. An FlatpakRef object (or short: ref)
  * can refer to either of these.
@@ -39,6 +39,8 @@
  * flatpak_ref_parse() and flatpak_ref_format_ref() can be used to convert
  * FlatpakRef objects into this string representation and back.
  *
+ * FlatpakRef objects are immutable and can be passed freely between threads.
+ *
  * To uniquely identify a particular version of an application or runtime, you
  * need a commit.
  *