Docs copy revision

[kanitw]

list of data of mark; labels will not collide with these marks

• [x] List of data of marks? This sounds a bit confusing. Are they mark group's names?

the amount of pixels label can extend pass chart bounding box.

• [x] Adding explanatory figure would be helpful.

[kanitw]

From the example above, Vega-Label will try to place label with no offset.

• [x] Why no offset? Aren't the values = 1?

If it cannot place the label, Vega-Label will try to place label with offset value 2. If it cannot place the label, Vega-Label will try to place label with offset value 1 inside its mark. Note: label will be placed inside its mark if offset is negative.

This part reads quite confusing. Can you clarify what you mean?

[kanitw]

It's worth doing a better job why this library is powerful too. (Be better at selling your work.)

This example is from Vega Connected Scatter Plot Example

• [x] Explain why your new specification is better (i.e., do not have to cheat by pre-specifying the direction)

This example is from Vega Job Voyager Example

• [x] Explain why your new specification is simpler.

This example is inspired by Vega-Lite Carbon Dioxide in the Atmosphere

• [x] Explain why your new specification is simpler.

This example is inspired by Vega Stacked Bar Chart Example

• [x] You add label to the original example. Be clear to see your work.