Improve documentation

[delvedor]

At the moment the documentation is almost complex as the actual code, we should fix that.

[poupryc]

Also for the app.use(func, [opts]): Loads one or more functions asynchronously. The function must have the signature: instance, options, done

Is it an inconsistency or misunderstanding on my part that the asynchronous function does not respect the signature?

async function plugin (server, opts) {} // without done

PS: This is to help me in writing Typescript definitions ^^

[mcollina]

As said the docs can be improved. There is no need for done  with async functions.

[minemax-ua]

The documentation definitely needs a complete overhaul.

[mcollina]

Would you like to help?

[minemax-ua]

Would you like to help?

I prefer to help with something I know very well, so it's rather No.