[How to] add documentation for the /auth/xxx endpoints

[idealley]

I had to figure out how to do this. Here is what I did:

I did not want the documentation for the token endpoints thus I removed them from the object:
services/authentication/index.js

  ...
  app.configure(authentication(config));
  //Removing endpoints from the documentation
  delete app.docs.paths['/auth/token'];
  delete app.docs.paths['/auth/token/{id}'];

Then I merged a definition that I keep in a separate file (here is an explanation or check the project I am working on)

app.docs.paths['/auth/token'].post = Object.assign({}, app.docs.paths['/auth/token'].post, def.post);