docs: about time for plugins

[Exirel]

Description

This is a first attempt at a documentation about time management for Plugin author. I think way more could be written, yet it will do for now. I don't want to have something blocked in a perpetual draft state because "it could be better". Of course it can be better, and it'll be. In future PRs.

Checklist

• I have read CONTRIBUTING.md
• I can and do license this contribution under the EFLv2
• No issues are reported by make qa (runs make quality and make test)
• I have tested the functionality of the things this change touches

[dgw]

Set the 8.0 milestone as a goal. 😁

I'm a little bit 🤔 about putting this in plugin/bot.rst, but there isn't really a better place other than shoehorning it into api.rst before the automodule docs for tools.time.

[Exirel]

but there isn't really a better place

And maybe we could split bot.rst into different files? Like so:

• plugin/bot.rst
  • plugin/bot/talk.rst
  • plugin/bot/style.rst
  • plugin/bot/channels.rst
  • plugin/bot/time.rst

What do you think? If you agree, I'd suggest to ship this PR, then split in a future PR.

[dgw]

Nitpick mode engaged, again… Are you tired of me yet? 🙉

I do indeed like the idea of making the bot-related docs a bit more digestible by splitting them into separate pages, and I also agree that that's best left for a future patch.

Note I'm only submitting this as "Request changes" because apparently I didn't submit the previous review as such, and I want this PR to show a clear status in the list—i.e. not look like it's unreviewed.

[dgw]

I like it. Instead of putting a ring on it, I'll just ask you to make LGTM happy. 😁

[Exirel]

I like it. Instead of putting a ring on it, I'll just ask you to make LGTM happy. grin

This is a joke:

Completed in 21s — No code changes detected

LGTM is now happy.

[dgw]

This is a joke

Of course it was a joke, lol. LGTM was only complaining because it "can't" analyze PRs with merge conflicts. 🤷‍♂️