summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/release/2.0.0-notes.rst5
-rw-r--r--doc/source/reference/arrays.maskna.rst5
2 files changed, 10 insertions, 0 deletions
diff --git a/doc/release/2.0.0-notes.rst b/doc/release/2.0.0-notes.rst
index 7c2bfa8a5..eec2b7933 100644
--- a/doc/release/2.0.0-notes.rst
+++ b/doc/release/2.0.0-notes.rst
@@ -18,6 +18,11 @@ Preliminary support for NA missing values similar to those in R has
been implemented. This was done by adding optional NA masks to the core
array object.
+.. note:: The NA API is *experimental*, and may undergo changes in future
+ versions of NumPy. The current implementation based on masks will likely be
+ supplemented by a second one based on bit-patterns, and it is possible that
+ a difference will be made between missing and ignored data.
+
While a significant amount of the NumPy functionality has been extended to
support NA masks, not everything is yet supported. Here is an (incomplete)
list of things that do and do not work with NA values:
diff --git a/doc/source/reference/arrays.maskna.rst b/doc/source/reference/arrays.maskna.rst
index 2faabde83..bd9516eba 100644
--- a/doc/source/reference/arrays.maskna.rst
+++ b/doc/source/reference/arrays.maskna.rst
@@ -14,6 +14,11 @@ core ndarray. This system is highly flexible, allowing NAs to be used
with any underlying dtype, and supports creating multiple views of the same
data with different choices of NAs.
+.. note:: The NA API is *experimental*, and may undergo changes in future
+ versions of NumPy. The current implementation based on masks will likely be
+ supplemented by a second one based on bit-patterns, and it is possible that
+ a difference will be made between missing and ignored data.
+
Other Missing Data Approaches
=============================