mapbox / mapbox-gl-style-spec

76 stars 38 forks source link

Hard to see category of property in documentation #651

Closed stevage closed 7 years ago

stevage commented 7 years ago

Just a usability issue I run into a lot with the docs. Say you're looking at this property: https://www.mapbox.com/mapbox-gl-style-spec/#paint-icon-translate-anchor

You can't see whether it's a layout, paint, etc property. The only way to find that out is to scroll up, sometimes quite a long way.

It would be great if it was somehow possible to see that information on the same page as the property itself. Maybe:

mollymerp commented 7 years ago

Thanks for your request @stevage - I have run into this as well. We'd be thrilled to see a PR implementing one of those options. I lean towards the second two options for clarity.

lucaswoj commented 7 years ago

This issue was moved to mapbox/mapbox-gl-js#4169