[api] Add comments to guide future API changes.

Author: Breakthrough

scenedetect/scene_detector.py

@@ -31,7 +31,13 @@
 
 from scenedetect.stats_manager import StatsManager
 
-
+# TODO(v0.7): Add a new base class called just "Detector" to eventually replace SceneDetector.
+#
+# class Detector:
+#     def process(buffer: ty.List[ty.Tuple[numpy.ndarray, FrameTimecode]]):
+#         # Return EventType.CUT, FADE_IN, FADE_OUT, etc...
+#         pass
+#
 class SceneDetector:
     """Base class to inherit from when implementing a scene detection algorithm.
 
@@ -125,6 +131,7 @@ def event_buffer_length(self) -> int:
         return 0
 
 
+# TODO(v0.7): Remove this early, no point in keeping it around.
 class SparseSceneDetector(SceneDetector):
     """Base class to inherit from when implementing a sparse scene detection algorithm.