From c5501f56b3eac0a62d2f69d4e6c2d6f7a5aaa5cb Mon Sep 17 00:00:00 2001
From: Xiaoji Chen <Pessimistress@users.noreply.github.com>
Date: Tue, 16 Feb 2021 10:51:07 -0800
Subject: [PATCH] Clarify ref migration in upgrade guide (#1356)

---
 docs/upgrade-guide.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/upgrade-guide.md b/docs/upgrade-guide.md
index 4abf5448..501a8856 100644
--- a/docs/upgrade-guide.md
+++ b/docs/upgrade-guide.md
@@ -16,6 +16,10 @@ const CONTROLLER_OPTS = {
 <MapGL {...CONTROLLER_OPTS} ... />
 ```
 
+- `Source` and `Layer` components no longer expose imperative methods via `ref` as part of the migration to functional components. This is to comply with the pattern recommended by the latest React.
+  + If you used to call `sourceRef.getSource()`, it can be replaced with `mapRef().getMap().getSource(sourceId)`.
+  + If you used to call `layerRef.getLayer()`, it can be replaced with `mapRef().getMap().getLayer(layerId)`.
+
 ## Upgrading to v6
 
 - A valid Mapbox access token is always required.