search

mapbox / mapbox-gl-js

Interactive, thoroughly customizable maps in the browser, powered by vector tiles and WebGL
https://docs.mapbox.com/mapbox-gl-js/
Other
11.09k stars 2.21k forks source link

Add to getting started: How to run and test GL #726

Closed amyleew closed 10 years ago

amyleew commented 10 years ago

May be helpful to add to docs how to run and test GL. Such as by using https://github.com/visionmedia/serve or via webserver (LAMP/WAMP) or apache.

jfirebaugh commented 10 years ago

@amyleew Do you mean local testing in a repository checkout? This is covered in the README.

amyleew commented 10 years ago

@jfirebaugh Yes. Would be help to mention / link to this information here as well https://www.mapbox.com/mapbox-gl/? As the final step in the process; Authorize, Style, and Run.

jfirebaugh commented 10 years ago

There's two different audiences here: developers using Mapbox GL in their own projects, and developers working on Mapbox GL itself. The landing page is for the former, and as with Mapbox.js, there's not too much we can say about how to actually serve your own project -- it's very project specific, varies widely, and will be background knowledge for most people coming to that page. The README is for developers working on Mapbox GL itself, so that's where we talk about the particular conventions that we use (npm start and so on).

amyleew commented 10 years ago

will be background knowledge for most people coming to that page

What about designers / cartographers styling with Mapbox GL? Possibly coming from Mapbox GL Style Spec or Mapbox GL JS. This is in response to feedback that it may be unclear it needs to be run locally or hosted to see their styling.