Added some doc to bearing and position

[cammace]

Could I get some clarification on bearing range @zugaldia? I'm also testing the waters with better ways to comment sections of the class. For example, you were using this style in position.java:

/*
 * Factories
 */

which I changed to:

// ****************************** Factories ******************************

another option I've seen in some libraries is:

// ------------------------------------------------------------------------
// Factories
// ------------------------------------------------------------------------

Not sure if you prefer your way of commenting them or if you just want to get rid of it all together. I do like breaking up the code like this though.

[zugaldia]

Sure thing. Bearing ranges are explained in https://www.mapbox.com/api-documentation/directions-v5.html as part of the StepManeuver object.

bearing_before: Number between 0 and 360 indicating the clockwise angle from true north to the direction of travel right before the maneuver

bearing_after: Number between 0 and 360 indicating the clockwise angle from true north to the direction of travel right after the maneuver

Regarding comments, let's keep them consistent with the main SDK. Either:

//
// Factories
//

or

/*
 * Factories
 */

Unless @tobrun or @bleege have a strong opinion otherwise.

[bleege]

👍

[cammace]

so in this case, direction is bearing_before and range would be bearing_after?

[zugaldia]

I'm afraid this is a concept that it's still fluctuating as the new API gets released. Let's pause on v5 docs for now.

[cammace]

@zugaldia if everything looks good, this PR is good to go then!

[zugaldia]

@cammace Thanks! Merging with minor edits. Leaving bering for until after v5.