Add note to docs about using sched with @rate

[dgw]

No description provided.

[dgw]

I'm revisiting this from the future to note that it was spurred by behavior described in #824.

This note seems not to apply any more after the rule-system rewrite for 7.x; the callable's start time is now used for rate-limiting if it hasn't completed yet:

sopel/sopel/plugins/rules.py

Lines 485 to 492 in 1c6aeb9

	@property
	def last_time(self) -> Optional[datetime.datetime]:
	"""Last recorded start/end time for the associated rule."""
	# detect if we just started something or if it ended
	if (self.started_at and self.ended_at) and (self.started_at < self.ended_at):
	return self.ended_at
	return self.started_at

Quick and dirty plugin to test sched's behavior with rate-limiting in 8.0

import sched
import time

from sopel import plugin


s = sched.scheduler(time.time, time.sleep)


@plugin.rate(60)
@plugin.command('testrate')
def rate_limited(bot, trigger):
    s.enter(30, 2, bot.say, argument=('hi',))
    s.run()