From 0d89263338638b412d91412689bb154083dd1502 Mon Sep 17 00:00:00 2001
From: Rifa Achrinza <25147899+achrinza@users.noreply.github.com>
Date: Mon, 20 Jan 2020 14:00:21 +0800
Subject: [PATCH] docs: add lb3 parity warnings

Signed-off-by: Rifa Achrinza <25147899+achrinza@users.noreply.github.com>
---
 docs/site/Understanding-the-differences.md | 2 ++
 docs/site/index.md                         | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/docs/site/Understanding-the-differences.md b/docs/site/Understanding-the-differences.md
index 4e2409a721ec..387a61cc465b 100644
--- a/docs/site/Understanding-the-differences.md
+++ b/docs/site/Understanding-the-differences.md
@@ -42,6 +42,8 @@ model definitions, migrating their application incrementally.
 
 ## Concept/feature mapping
 
+{% include note.html content="See the [GitHub issue](https://github.com/strongloop/loopback-next/issues/1920) for a full list of features that have not been migrated to LoopBack 4." %}
+
 In Loopback 3.x (and earlier), models were responsible for both accessing data
 in other systems (databases, SOAP services, etc.) and providing the
 application's external REST API. This made it easy to quickly build a REST
diff --git a/docs/site/index.md b/docs/site/index.md
index d531048e1ac2..48f93abcae21 100644
--- a/docs/site/index.md
+++ b/docs/site/index.md
@@ -15,6 +15,8 @@ multiple repos, as in v3. However, examples and externally-developed components
 will be in separate repositories.
 '%}
 
+{% include important.html content="Certain features from LoopBack 3 may still be a work in progress or are not planned to be migrated to LoopBack 4. See [Understanding the differences](understanding-the-differences.md)." %}
+
 LoopBack is a highly extensible, open-source Node.js and TypeScript framework
 based on Express that enables you to quickly create APIs and microservices
 composed from backend systems such as databases and SOAP or REST services.