diff --git a/doc/07-runtime.md b/doc/07-runtime.md
index 35d4276fb..4faef5e07 100644
--- a/doc/07-runtime.md
+++ b/doc/07-runtime.md
@@ -72,6 +72,20 @@ package.
 \Composer\InstalledVersions::getReference('vendor/package');
 ```
 
+### Knowing a package's own installed version
+
+If you are only interested in getting a package's own version, e.g. in the source of acme/foo you want
+to know which version acme/foo is currently running to display that to the user, then it is
+acceptable to use getVersion/getPrettyVersion/getReference.
+
+The warning in the section above does not apply in this case as you are sure the package is present
+and not being replaced if your code is running.
+
+It is nonetheless a good idea to make sure you handle the `null` return value as gracefully as
+possible for safety.
+
+----
+
 A few other methods are available for more complex usages, please refer to the
 source/docblocks of the class itself.