DOC: Removing repeated NA (pandas-dev#54821)

* Remove repetead NA * Added file to toctree * changed _api.missing_value * Added NaT to missing values section --------- Co-authored-by: Marco Edward Gorelli <[email protected]>
paulreece · Sep 29, 2023 · c8e7a98 · c8e7a98
1 parent 8f20e82
commit c8e7a98
Show file tree

Hide file tree

Showing 3 changed files with 25 additions and 13 deletions.
diff --git a/doc/source/reference/arrays.rst b/doc/source/reference/arrays.rst
@@ -134,11 +134,6 @@ is the missing value for datetime data.
 
    Timestamp
 
-.. autosummary::
-   :toctree: api/
-
-   NaT
-
 Properties
 ~~~~~~~~~~
 .. autosummary::
@@ -257,11 +252,6 @@ is the missing value for timedelta data.
 
    Timedelta
 
-.. autosummary::
-   :toctree: api/
-
-   NaT
-
 Properties
 ~~~~~~~~~~
 .. autosummary::
@@ -465,7 +455,6 @@ pandas provides this through :class:`arrays.IntegerArray`.
    UInt16Dtype
    UInt32Dtype
    UInt64Dtype
-   NA
 
 .. _api.arrays.float_na:
 
@@ -484,7 +473,6 @@ Nullable float
 
    Float32Dtype
    Float64Dtype
-   NA
 
 .. _api.arrays.categorical:
 
@@ -621,7 +609,6 @@ with a bool :class:`numpy.ndarray`.
    :template: autosummary/class_without_autosummary.rst
 
    BooleanDtype
-   NA
 
 
 .. Dtype attributes which are manually listed in their docstrings: including

diff --git a/doc/source/reference/index.rst b/doc/source/reference/index.rst
@@ -53,6 +53,7 @@ are mentioned in the documentation.
    options
    extensions
    testing
+   missing_value
 
 .. This is to prevent warnings in the doc build. We don't want to encourage
 .. these methods.

diff --git a/doc/source/reference/missing_value.rst b/doc/source/reference/missing_value.rst
@@ -0,0 +1,24 @@
+{{ header }}
+
+.. _api.missing_value:
+
+==============
+Missing values
+==============
+.. currentmodule:: pandas
+
+NA is the way to represent missing values for nullable dtypes (see below):
+
+.. autosummary::
+   :toctree: api/
+   :template: autosummary/class_without_autosummary.rst
+
+   NA
+
+NaT is the missing value for timedelta and datetime data (see below):
+
+.. autosummary::
+   :toctree: api/
+   :template: autosummary/class_without_autosummary.rst
+
+   NaT