Update documentation about tokens (visgl#2204)

Author: Pessimistress

README.md

@@ -11,7 +11,7 @@
 
 <h1 align="center">react-map-gl | <a href="https://visgl.github.io/react-map-gl">Docs</a></h1>
 
-`react-map-gl` is a suite of [React](http://facebook.github.io/react/) components designed to provide a React API for [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js)-compatible libraries. More information in the online documentation.
+`react-map-gl` is a suite of [React](http://facebook.github.io/react/) components designed to provide a React API for [mapbox-gl](https://github.com/mapbox/mapbox-gl-js) or [maplibre-gl](https://maplibre.org/maplibre-gl-js-docs/api/). More information in the online documentation.
 
 See our [Design Philosophy](docs/README.md#design-philosophy).
 

docs/README.md

@@ -16,7 +16,7 @@
 </p>
 
 react-map-gl is a suite of [React](http://facebook.github.io/react/) components for
-Mapbox GL JS-compatible libraries.
+[mapbox-gl](https://github.com/mapbox/mapbox-gl-js), [maplibre-gl](https://maplibre.org/maplibre-gl-js-docs/api/) or compatible libraries.
 
 | Library | Description |
 | --- | --- | 

docs/get-started/mapbox-tokens.md

@@ -1,12 +1,12 @@
 # About Mapbox Tokens
 
-`react-map-gl` itself is open source and free. It provides a React wrapper for `mapbox-gl` or derived projects.
-Depending on which Mapbox GL JS version (or fork) you use, you may need a Mapbox token. You will need a Mapbox token if you use:
+`react-map-gl` itself is open source and free. It provides a React wrapper for `mapbox-gl`, `maplibre-gl` or compatible projects.
+Depending on which base map library you use, you may need a Mapbox token. You will need a Mapbox token if you use:
 
--  [mapbox-gl@>=2.0.0](https://github.com/mapbox/mapbox-gl-js/releases/tag/v2.0.0) and above - requires a mapbox access token in order to access the map renderer, and generates billable events regardlesss of whether you are displaying your own maps.
--  `[email protected]` or [maplibre-gl](https://github.com/maplibre/maplibre-gl-js) - requires an access token only if you load the map styles and tiles from Mapbox's data service. See "Display Maps Without A Mapbox Token" section below for using non-Mapbox tiles.
+-  [mapbox-gl@>=2.0.0](https://github.com/mapbox/mapbox-gl-js/releases/tag/v2.0.0) - requires a mapbox access token in order to access the map renderer, and generates billable events regardlesss of whether you are displaying your own maps.
+-  `[email protected]` or `maplibre-gl@1.x` - requires an access token only if you load the map styles and tiles from Mapbox's data service. See "Display Maps Without A Mapbox Token" section below for using non-Mapbox tiles.
 
-To get a Mapbox token, you will need to register on [their website](https://www.mapbox.com). The token will be used to identify you and start serving up map tiles. The service is free until a certain level of traffic is exceeded.
+To get a Mapbox token, you will need to register on [the Mapbox website](https://www.mapbox.com). The token will be used to identify you and start serving up map tiles. The service is free until a certain level of traffic is exceeded.
 
 There are several ways to provide a token to your app, as showcased in some of the example folders:
 
@@ -18,22 +18,25 @@ We recommend using an environment variable to minimize leaking risks. See [secur
 
 ## Display Maps Without A Mapbox Token
 
-It is possible to use the map component without the Mapbox service, if you use another tile source (for example, if you host your own map tiles). Note that this is no longer allowed using mapbox-gl v2.0 and above. The options are:
+It is possible to use the map component without the Mapbox service, if you use another tile source (for example, if you host your own map tiles). Note that this is no longer allowed using `mapbox-gl` v2.0 and above. The options are:
 
+- Use [maplibre-gl](https://maplibre.org/maplibre-gl-js-docs/api/). See [Get Started](./get-started.md) for how to configure your project.
 - Stay on `[email protected]`. react-map-gl plans to continue supporting this release in the foreseeable future, however, this version will not include any of the latest features of the map renderer, nor get any future updates from Mapbox.
-- Use a community fork of mapbox-gl, for example [maplibre-gl](https://www.npmjs.com/package/maplibre-gl). See [Get Started](./get-started.md) for how to configure your project.
 
-To use your own map service, you will need a custom Mapbox GL style that points to your own [vector tile source](https://www.mapbox.com/mapbox-gl-js/style-spec/), and pass it to `Map` using the `mapStyle` prop. This custom style must match the schema of your tile source.
+To use your own map service, you will need a custom map style that points to your own [tile source](https://maplibre.org/maplibre-style-spec/sources/), and pass it to `Map` using the `mapStyle` prop.
 
-Open source tile schemas include:
+Some alternative map data providers include:
 
-- [TileZen schema](https://tilezen.readthedocs.io/en/latest/layers/)
-- [OpenMapTiles schema ](https://openmaptiles.org/schema/)
+- [MapTiler](https://www.maptiler.com)
+- [Amazon Location Service](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html)
 
-Some useful resources for creating your own map service:
+Useful resources for creating your own map tiles and service:
 
-- [Mapbox Vector Tile Spec](https://www.mapbox.com/developers/vector-tiles/)
-- [Open source tools](https://github.com/mapbox/awesome-vector-tiles)
+- [Martin Tile Server](https://maplibre.org/martin/introduction.html)
+- [OpenMapTiles](https://openmaptiles.org)
+- [Mapbox Vector Tile Spec](https://github.com/mapbox/vector-tile-spec)
+- [PMTiles](https://github.com/protomaps/PMTiles)
+- [List of open source tools](https://github.com/mapbox/awesome-vector-tiles)
 
 If you are using a third party service that requires header based authentication, you can do this by defining a function to pass to `Map` using the `transformRequest` prop.