[not ready] Docs updates

about to ping a bunch of people about TODOs here, be ready
The value should be pixels and 0 should be the default (an antialiased line without any visible fade). Issue for fixing the implementation: https://github.com/mapbox/mapbox-gl-js/issues/615