From 7c202b9198453cf6b1d512dae78add24719d4f23 Mon Sep 17 00:00:00 2001
From: Agnes Lin <agneslin.lin@ibm.com>
Date: Wed, 5 Aug 2020 17:12:23 -0400
Subject: [PATCH] docs: reorganize connector reference into reference, how-to
 guides and tutorials

---
 docs/site/Configuring-datasource.md           | 23 +++++++++++++++++++
 docs/site/DataSources.md                      | 14 +++++++++++
 docs/site/sidebars/lb4_sidebar.yml            |  8 +++++++
 .../connectors/Connecting-to-back-end.md      | 16 +++++++++++++
 4 files changed, 61 insertions(+)
 create mode 100644 docs/site/Configuring-datasource.md
 create mode 100644 docs/site/tutorials/connectors/Connecting-to-back-end.md

diff --git a/docs/site/Configuring-datasource.md b/docs/site/Configuring-datasource.md
new file mode 100644
index 000000000000..90f4b89b4808
--- /dev/null
+++ b/docs/site/Configuring-datasource.md
@@ -0,0 +1,23 @@
+---
+lang: en
+title: 'Configuring DataSource'
+keywords: LoopBack 4.0, LoopBack 4, Node.js, TypeScript, Connector, Datasource
+sidebar: lb4_sidebar
+permalink: /doc/en/lb4/Configuring-datasource.html
+---
+
+## Overview
+
+<!-- TODO
+
+- how to configure the connector ( what properties the connector configuration
+  might take
+- how type maps ⚠️ should finish task https://github.com/strongloop/loopback-next/issues/5063
+  - to database (Database Migration), e.g String -> Varchar, Boolean -> Tinyint
+  - from database (Discovery), e.g Bigint -> int, Text -> String
+- how to customize table/column names
+- how to discover/migration tables/models
+- list connector specific topics, e.g transaction, objectId, and read should check the corresponding connector pages.
+- add links to connector reference
+
+ -->
diff --git a/docs/site/DataSources.md b/docs/site/DataSources.md
index 1f233e63a7bb..b20c2a96f9c7 100644
--- a/docs/site/DataSources.md
+++ b/docs/site/DataSources.md
@@ -81,3 +81,17 @@ Attach the newly created datasource to the app by calling `app.dataSource()`.
 The `app.datasource()` method is available only on application classes
 with `RepositoryMixin` applied.
 " %}
+
+### Connector
+
+<!-- TODO
+
+- what is connectors
+- what role it plays in req/res cycle, and what relation it has between model and other artifacts (briefly)
+- connector types (add links ):
+  - SQL (transaction), NoSQL (freeform properties)
+  - Services connectors (service proxy) and others
+  - (optional) In-memory connector
+  - (optional) Community connector
+
+  -->
diff --git a/docs/site/sidebars/lb4_sidebar.yml b/docs/site/sidebars/lb4_sidebar.yml
index 6b54748f5ee9..52de2d526c24 100644
--- a/docs/site/sidebars/lb4_sidebar.yml
+++ b/docs/site/sidebars/lb4_sidebar.yml
@@ -91,6 +91,10 @@ children:
       url: todo-list-tutorial-sqldb.html
       output: 'web, pdf'
 
+  - title: 'Connecting to Back-end Service Tutorials'
+    url: Connecting-to-back-end.html
+    output: 'web, pdf'
+
   - title: 'SOAP Web Service Tutorial'
     url: soap-calculator-tutorial.html
     output: 'web, pdf'
@@ -200,6 +204,10 @@ children:
     output: 'web, pdf'
     children:
 
+    - title: 'Configuring DataSource'
+      url: Configuring-datasource.html
+      output: 'web, pdf'
+
     - title: 'Working with data'
       url: Working-with-data.html
       output: 'web, pdf'
diff --git a/docs/site/tutorials/connectors/Connecting-to-back-end.md b/docs/site/tutorials/connectors/Connecting-to-back-end.md
new file mode 100644
index 000000000000..b7bffdaa96ae
--- /dev/null
+++ b/docs/site/tutorials/connectors/Connecting-to-back-end.md
@@ -0,0 +1,16 @@
+---
+lang: en
+title: 'Connecting to Back-end Service Tutorials'
+keywords:
+  LoopBack 4.0, LoopBack 4, Node.js, TypeScript, Tutorial, Connector, Datasource
+sidebar: lb4_sidebar
+permalink: /doc/en/lb4/Connecting-to-back-end.html
+---
+
+<!-- TODO
+
+- Briefly introduce what is connectors and what connectors LB provides.
+- List the connector tutorials we have in connector ref (MySQL, PostgreSQL, Oracle, and MongoDB)
+- Add the link to connector ref
+
+-->