Add uncaptured details from PRs to Docs

[jdiddydave]

I went through our merged PRs to review any merged (from April 2024 through now) features that have not yet been documented.

There probably needs to be a bigger re-imagination of the docs for V1.

Larger Changes

• The Serialization section has been combined with Configurable database connections info into a new section called Storage
• Added a Listeners section

Remaining Changes

• We need to add boot to the event-lifecycle pdf

Additions

• add autofill clarifications, code example

  • @where ids

• fireIfValid

  • By default, if an event fails validation it will throw an exception; if you want to fire ONLY if validation succeeds, use fireIfValid()
  • @where events-lifecycle

• skipPhases

  • Verbs::skipPhases(Phase::Foo);
  • @where testing

• outside listeners

  • registering Verbs::listen(FooListener::class) and using listeners
  • @where listeners

• Allow for listening for parent classes or interfaces

  • You can use listeners on specific events, the entire event class, or interfaces
  • @where listeners

• dependency injection

  • @where events -- see Typed Parameters

• metadata

  • add put and get to examples
  • @where metadata

• Configurable database connections

  • @where storage

• Use states on events directly

• FooState::new() shorthand

  • @where states -- see load

• Events can pass a state as a param

  • @where events -- see Typed Parameters

• State::load() can load multiple states

  • @where states -- see load

• Phase::Boot

  • @where event-lifecycle