Deprecate Time module and all its schedulers

Add a warning message that all the whole time module and all its schedulers are deprecated

mesa/time.py

@@ -31,6 +31,15 @@
 from mesa.agent import Agent, AgentSet
 from mesa.model import Model
 
+# Throw module-level deprecation warning
+warnings.warn(
+    "The time module and all its Schedulers are deprecated and will be removed in a future version. "
+    "They can be replaced with AgentSet functionality. See the migration guide for details. "
+    "https://mesa.readthedocs.io/en/latest/migration_guide.html#time-and-schedulers",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 # BaseScheduler has a self.time of int, while
 # StagedActivation has a self.time of float
 TimeT = float | int