refinement

dougbrn · dougbrn · commit 4b76f5e4301d · 2025-04-04T16:05:34.000-07:00
diff --git a/.gitignore b/.gitignore
@@ -72,6 +72,7 @@ instance/
 # Sphinx documentation
 docs/_build/
 _readthedocs/
+docs/reference/api/
 
 # PyBuilder
 target/
diff --git a/docs/reference.rst b/docs/reference.rst
@@ -1,13 +1,12 @@
-API Reference (Test)
+API Reference
 ========================================================================================
 
 .. toctree::
     :maxdepth: 2
 
     NestedFrame <reference/nestedframe>
     .nest Accessor <reference/accessor>
-    NestedDtype <reference/nesteddtype>
-    Datasets <reference/datasets>
     Utility Functions <reference/utils>
+    NestedDtype <reference/nesteddtype>
     Nested Extension Array <reference/ext_array>
     Packer Functions <reference/packer>
diff --git a/docs/reference/datasets.rst b/docs/reference/datasets.rst
diff --git a/docs/reference/nestedframe.rst b/docs/reference/nestedframe.rst
@@ -19,8 +19,16 @@ Nesting
     NestedFrame.from_flat
     NestedFrame.from_lists
 
-Extended Pandas Interface
-~~~~~~~~~
+Extended Pandas.DataFrame Interface
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. note:: 
+   The NestedFrame extends the Pandas.DataFrame interface, so all methods
+   of Pandas.DataFrame are available. The following methods are extended
+   to support NestedFrame functionality. Please reference the Pandas
+   documentation for more information.
+   https://pandas.pydata.org/docs/reference/frame.html
+   
 .. autosummary::
     :toctree: api/
 
diff --git a/docs/reference/utils.rst b/docs/reference/utils.rst
@@ -3,9 +3,17 @@ Utility Functions
 =========
 .. currentmodule:: nested_pandas
 
-Functions
+NestedFrame Utilities
 ~~~~~~~~~
 .. autosummary::
     :toctree: api/
     
-    utils.count_nested
+    utils.count_nested
+
+Generating Toy Datasets
+~~~~~~~~~
+.. autosummary::
+    :toctree: api/
+    
+    datasets.generation.generate_data
+    datasets.generation.generate_parquet_file
diff --git a/src/nested_pandas/nestedframe/core.py b/src/nested_pandas/nestedframe/core.py
@@ -370,13 +370,12 @@ def from_lists(cls, df, base_columns=None, list_columns=None, name="nested"):
         NestedFrame
             A NestedFrame with the specified nesting structure.
 
-         Examples
+        Examples
         --------
 
         >>> nf = NestedFrame({"c":[1,2,3], "d":[2,4,6],
         ...                   "e":[[1,2,3], [4,5,6], [7,8,9]]},
-        ...                  index=[0,1,2])
-
+        ...                   index=[0,1,2])
 
         >>> NestedFrame.from_lists(nf, base_columns=["c","d"])
         """
