Please document what these various methods across socketcluster should be returning. It would be incredibly helpful to see .attach in the documentation and know what type of object it's creating and returning, rather than having to resort to examining the code directly.

https://socketcluster.io/docs/authentication/#verify-and-use-the-jwt-token

agServer.addMiddleware(agServer.MIDDLEWARE_INBOUND, async (middlewareStream) => {
  for await (let action of middlewareStream) {

Not sure what that needs to be. My best guess on context is .setMiddleware?

When trying to locate the release notes of the previous versions of socketcluster, I ran into some broken links:

v15.0.6 points to https://github.com/SocketCluster/socketcluster-website/releases/tag/v15.0.6 and v14.4.2 points to https://github.com/SocketCluster/socketcluster-website/releases/tag/v14.4.2 but there is nothing there.

This is partly because they point to the releases tags of the socketcluster-website repository where there are none, but even when they would point to the socketcluster repository, it would not work as that v14.4.2 version is not in the releases.

• top of middleware page says scServer, examples say wsServer. Should all say scServer.
• Nothing mentions the interface for req (data, waitForAuth, socket...)

will PR when i finish the sprint & find more stuff as I read the guide with fresh, forgetful eyes 😄

"Default server auth engine" points to https://github.com/SocketCluster/socketcluster/blob/master/lib/auth.js which returns a 404.

On this page, next to clients property: https://socketcluster.io/#!/docs/api-scserver

While reading the documentation on http://socketcluster.io/#!/docs/getting-started using Chrome (Version 50.0.2661.102 64-bit - Mac OS X 10.11.4), the progress indicator keeps flashing every few seconds. This is very annoying and distracting.