JS: doc: cleanup, example writing and completeness

I guess the JS Doc needs a bit more explanation/detailed love

Looking here:
http://aerogear.org/docs/specs/aerogear-js/AeroGear.Pipeline.html

I think (for instance) it's not really clear what this means:

add(config) → {Object}

Even if the page has some doc on the config object, it's not clear that this (especially the settings) are 'valid' to use:

...
name: "projects",
settings: {
            agAuth: true,
            baseURL: "/todo-server/",
            endpoints: {
                enroll: "auth/register"
            }
        }
...

I think this is true for other modules/functions as well