Merge branch 'release' into 'master'

Add more notes and warnings about releases

See merge request !296

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,