fixup! split auth into 3 pages, improve sidebar

bajtos · bajtos · commit 5027cd6d082c · 2019-10-15T14:01:52.000+02:00
Signed-off-by: Miroslav Bajtoš &lt;mbajtoss@gmail.com&gt;
diff --git a/docs/site/migration/auth/built-in.md b/docs/site/migration/auth/built-in.md
@@ -1,15 +1,13 @@
 ---
 lang: en
-title: 'Migrating authentication and authorization'
+title: 'Migrating built-in authentication and authorization'
 keywords: LoopBack 4.0, LoopBack 4, LoopBack 3, Migration
 sidebar: lb4_sidebar
-permalink: /doc/en/lb4/migration-authentication-authorization.html
+permalink: /doc/en/lb4/migration-auth-built-in.html
 ---
 
 TODO: explain how to migrate:
 
+- built-in models (User, AccessToken, ACL)
 - authentication
 - authorization
-- built-in models (User, AccessToken, ACL)
-- loopback-component-oauth2
-- loopback-component-passport
diff --git a/docs/site/migration/auth/oauth2.md b/docs/site/migration/auth/oauth2.md
@@ -0,0 +1,9 @@
+---
+lang: en
+title: 'Migrating OAuth2 provider'
+keywords: LoopBack 4.0, LoopBack 4, LoopBack 3, Migration
+sidebar: lb4_sidebar
+permalink: /doc/en/lb4/migration-auth-oauth2.html
+---
+
+TODO: explain how to migrate apps using loopback-component-oauth2
diff --git a/docs/site/migration/auth/overview.md b/docs/site/migration/auth/overview.md
@@ -0,0 +1,13 @@
+---
+lang: en
+title: 'Migrating authentication and authorization'
+keywords: LoopBack 4.0, LoopBack 4, LoopBack 3, Migration
+sidebar: lb4_sidebar
+permalink: /doc/en/lb4/migration-auth-overview.html
+---
+
+TODO: High-level description of the following migration steps:
+
+- built-in models (User, AccessToken, ACL), authentication & authorization
+- apps using loopback-component-passport
+- apps using loopback-component-oauth2
diff --git a/docs/site/migration/auth/passport.md b/docs/site/migration/auth/passport.md
@@ -0,0 +1,9 @@
+---
+lang: en
+title: 'Migrating Passport-based authentication'
+keywords: LoopBack 4.0, LoopBack 4, LoopBack 3, Migration
+sidebar: lb4_sidebar
+permalink: /doc/en/lb4/migration-auth-passport.html
+---
+
+TODO: explain how to migrate apps using loopback-component-passport
diff --git a/docs/site/migration/models/remoting-hooks.md b/docs/site/migration/models/remoting-hooks.md
@@ -13,4 +13,4 @@ TODO: Explain how to migrate remoting hooks to LB4 interceptors.
 - Method-level hooks, e.g. `User.beforeRemote('create', handlerFn)`
 
 Explain how to map properties provided by LB3 remoting context to LB4 concepts
-and how to access those data via Dependency Injection.
+and how to access that data via Dependency Injection.
diff --git a/docs/site/migration/overview.md b/docs/site/migration/overview.md
@@ -10,3 +10,5 @@ Migration guide from LoopBack 3 to LoopBack 4.
 
 TODO: explain the high-level plan for upgrading in incremental steps, point to
 sub-chapters for more details.
+
+List components & feature that are not planned for LB4.
diff --git a/docs/site/sidebars/lb4_sidebar.yml b/docs/site/sidebars/lb4_sidebar.yml
@@ -625,19 +625,19 @@ children:
   output: 'web, pdf'
   children:
 
-  - title: 'Understanding the differences between LoopBack 3 and LoopBack 4'
+  - title: 'Understanding the differences'
     url: Understanding-the-differences.html
     output: 'web, pdf'
 
   - title: 'Mounting a LoopBack 3 application'
     url: migration-mounting-lb3app.html
     output: 'web, pdf'
 
-  - title: 'Migrating datasources'
+  - title: 'Datasources'
     url: migration-datasources.html
     output: 'web, pdf'
 
-  - title: 'Migrating Express middleware'
+  - title: 'Express middleware'
     url: migration-express-middleware.html
     output: 'web, pdf'
 
@@ -675,8 +675,21 @@ children:
     output: 'web, pdf'
 
   - title: 'Authentication & authorization'
-    url: migration-authentication-authorization.html
+    url: migration-auth-overview.html
     output: 'web, pdf'
+    children:
+
+    - title: 'Built-in models'
+      url: migration-auth-built-in.html
+      output: 'web, pdf'
+
+    - title: 'Passport'
+      url: migration-auth-passport.html
+      output: 'web, pdf'
+
+    - title: 'OAuth2 Provider'
+      url: migration-auth-oauth2.html
+      output: 'web, pdf'
 
   - title: 'Components and extensions'
     url: migration-extensions.html
