Plugin function and event handler parameters are not documented

Looking at the docs I don't know what to expect as the parameters to initialize, page, track, and so on.

I do see it's an object with fields like payload, instance, config. But what are those things? I can infer config is the config of my plugin and payload is what was passed to the original track or page call. What is instance ?

When I call analytics.track('some event', { ... payload ... }), where does the event name go? Is it assigned into the payload or somewhere else?

I think I can piece it together by analyzing the code and plugins but it would be nice to beef up the docs in those areas for the benefit of others trying to write some custom plugins.

Start by reading the implementation of the initialize, page, and track handlers and the existing plugin documentation, then compare them with example plugins. Document the meanings of payload, instance, and config, including where the event name from analytics.track is placed. Done means a plugin author can determine each handler parameter from the docs without reverse-engineering the code.