diff --git a/doc/release.rst b/doc/release.rst
index 9484d5cb6c5e1143880cc06586c9eb7ae8e4c653..41bd94cd7e69b654d63ec836b2d4956d10e0dc8c 100644
--- a/doc/release.rst
+++ b/doc/release.rst
@@ -13,6 +13,12 @@ for the release build and documentation badges.  The tools are setup to ensure a
 changelog is provided with each release.  The changelog can be autogenerated
 from merge-requests or commits in the target package.
 
+.. warning::
+
+   Releasing any package that is listed in the nightlies repository requires a
+   green nightlies after all changes have been merged to the master branches of
+   all packages. Do not release a package because it is green by itself. Its
+   compatibility must be tested against all other packages first.
 
 Usage
 =====
@@ -27,6 +33,11 @@ Releasing Bob is a 4-step process:
 
 Use the ``--help`` flag in each command to learn more about each command.
 
+.. note::
+
+   If the package that you are releasing is not part of the nightlies
+   repository, you can skip steps 3 and 4.
+
 .. warning::
 
    While *beta* builds of packages will use the beta version of this package,