docs(utils): Note the APIs are internal

Author: tony

libvcs/utils/dataclasses.py

@@ -1,3 +1,9 @@
+""":mod:`dataclasses` utilities.
+
+Note
+----
+This is an internal API not covered by versioning policy.
+"""
 import dataclasses
 from operator import attrgetter
 

libvcs/utils/query_list.py

@@ -1,3 +1,9 @@
+"""Utilities for filtering or searching :class:`list` of objects / list data.
+
+Note
+----
+This is an internal API not covered by versioning policy.
+"""
 import re
 import traceback
 from typing import Any, Callable, Optional, Protocol, Sequence, TypeVar, Union

libvcs/utils/run.py

@@ -1,4 +1,11 @@
-"""Utility functions for libvcs."""
+"""Misc. legacy helpers :mod:`subprocess` and finding VCS binaries.
+
+:class:`libvcs.utils.run.run` will be deprecated by :mod:`libvcs.utils.subprocess`.
+
+Note
+----
+This is an internal API not covered by versioning policy.
+"""
 import datetime
 import errno
 import logging

libvcs/utils/subprocess.py

@@ -1,7 +1,14 @@
-"""Invokable subprocess wrapper.
+"""Invokable :mod:`subprocess` wrapper.
 
 Defer running a subprocess, such as by handing to an executor.
 
+Note
+----
+This is an internal API not covered by versioning policy.
+
+Examples
+--------
+
 - :class:`~SubprocessCommand`: Wraps :class:`subprocess.Popen` and
   :func:`subprocess.run` in a :func:`~dataclasses.dataclass`.