DOC: Fix docs on merging categoricals.

Fixes #28166.
pandas-dev · Oct 7, 2019 · 1b9bb12 · 1b9bb12
1 parent af498fe
commit 1b9bb12
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 6 deletions.
diff --git a/doc/source/user_guide/categorical.rst b/doc/source/user_guide/categorical.rst
@@ -813,16 +813,16 @@ but the categories of these categoricals need to be the same:
     res
     res.dtypes
 
-In this case the categories are not the same, and therefore an error is raised:
+If the categories are not exactly the same, merging will coerce the
+categoricals to their categories' dtypes:
 
 .. ipython:: python
 
     df_different = df.copy()
     df_different["cats"].cat.categories = ["c", "d"]
-    try:
-        pd.concat([df, df_different])
-    except ValueError as e:
-        print("ValueError:", str(e))
+    res = pd.concat([df, df_different])
+    res
+    res.dtypes
 
 The same applies to ``df.append(df_different)``.
 

diff --git a/doc/source/user_guide/merging.rst b/doc/source/user_guide/merging.rst
@@ -883,7 +883,7 @@ The merged result:
 .. note::
 
    The category dtypes must be *exactly* the same, meaning the same categories and the ordered attribute.
-   Otherwise the result will coerce to ``object`` dtype.
+   Otherwise the result will coerce to the categories' dtype.
 
 .. note::