# HG changeset patch
# User Greg Ward <greg@gerg.ca>
# Date 1428952681 14400
# Node ID 250835154f8f1a69cb7708e7adc6f0371abe640c
# Parent  ba3ff8c00304c74644bdd79c7d7294800e2acd9c
docs: explain that obsolete is not hidden

diff -r ba3ff8c00304 -r 250835154f8f docs/user-guide.rst
--- a/docs/user-guide.rst	Mon Apr 13 15:09:55 2015 -0400
+++ b/docs/user-guide.rst	Mon Apr 13 15:18:01 2015 -0400
@@ -334,7 +334,14 @@
 Obsolete is not hidden
 ======================
 
-TODO
+So far, every obsolete changeset we have seen is also hidden. However,
+these are *not* the same thing—that's why they have different names.
+It's entirely possible to have obsolete changesets that are not
+hidden. We'll see examples of that soon, when we create *unstable*
+changesets.
+
+Note that all hidden changesets are obsolete: hidden is a subset of
+obsolete.
 
 
 Life with ``evolve`` (advanced usage)