DOC: Add more docstrings with some renaming

docs/src/conf.py

@@ -1,11 +1,8 @@
 #!/usr/bin/env python3
 
-# flake8: noqa
-# pylint: skip-file
+import logging
 import os
 import sys
-from pathlib import Path
-
 from datetime import date
 
 import fmu.dataio
@@ -15,6 +12,19 @@
 sys.path.insert(1, os.path.abspath("../ext"))
 
 
+class PydanticAutodocFilter(logging.Filter):
+    """A logging filter to suppress warnings about duplicate object descriptions when
+    generating Pydantic model documentation. These warnings are a result of generating a
+    new nested model document wherever one occurs, even if this Pydantic model is used
+    in multiple places."""
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        return "duplicate object description" not in record.getMessage()
+
+
+logging.getLogger("sphinx").addFilter(PydanticAutodocFilter())
+
+
 # -- General configuration ---------------------------------------------
 
 # The full version, including alpha/beta/rc tags.

docs/src/datamodel/index.rst

@@ -32,8 +32,8 @@ documentation of these two models can be inspected from here.
    .. toctree::
       :maxdepth: -1
 
-      fmu.dataio.datastructure.meta.meta.FMUDataClassMeta
-      fmu.dataio.datastructure.meta.meta.FMUCaseClassMeta
+      ~fmu.dataio.datastructure.meta.meta.ObjectMetadata
+      ~fmu.dataio.datastructure.meta.meta.CaseMetadata
 
 
 About the data model