Improve restarts, add port forwarding, adjust docs.

Author: guzman-raphael

.devcontainer/devcontainer.json

@@ -16,7 +16,14 @@
 		"ghcr.io/guiyomh/features/vim:0": {}
 	},
 	"onCreateCommand": "pip install -e .",
-	"postStartCommand": "MYSQL_VER=5.7 MINIO_VER=RELEASE.2022-08-11T04-37-28Z docker compose -f local-docker-compose.yml up --build -d",
+	"postStartCommand": "MYSQL_VER=8.0 MINIO_VER=RELEASE.2022-08-11T04-37-28Z docker compose -f local-docker-compose.yml down && MYSQL_VER=8.0 MINIO_VER=RELEASE.2022-08-11T04-37-28Z docker compose -f local-docker-compose.yml up --build --wait",
+	"forwardPorts": [
+		80,
+		443,
+		3306,
+		8080,
+		9000
+	],
 	"customizations": {
 		"vscode": {
 			"extensions": [

docs/src/develop.md

@@ -2,27 +2,28 @@
 
 Included with the codebase is the recommended development environment configured using [DevContainer](https://containers.dev/).
 
-## Launch Development Environment
+## Launch Environment
 
 Here are some options that provide a great developer experience:
 
 - **Cloud-based IDE**: (*recommended*)
   - Launch using [GitHub Codespaces](https://github.com/features/codespaces) using the option `Create codespace on master` in the codebase repository on your fork.
   - Build time for a 2-Core codespace is **~5m**. This is done infrequently and cached for convenience.
   - Start time for a 2-Core codespace is **~1m**. This will pull the built codespace from cache when you need it.
-  - Tip: GitHub auto names the codespace but you can rename the codespace so that it is easier to identify later.
+  - *Tip*: GitHub auto names the codespace but you can rename the codespace so that it is easier to identify later.
 - **Local IDE**:
   - Ensure you have [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
   - Ensure you have [Docker](https://docs.docker.com/get-docker/)
   - Ensure you have [VSCode](https://code.visualstudio.com/)
   - Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
   - `git clone` the codebase repository and open it in VSCode
   - Use the `Dev Containers extension` to `Reopen in Container` (More info in the `Getting started` included with the extension)
-  - Your environment will finish loading once the file tree is populated and the terminal become active
+
+You will know your environment has finished loading once you see a terminal open related to `Running postStartCommand` with a final message: `Done`.
 
 ## Features
 
-Once you've successfully launched the development environment, you'll be able to take advantage of our developer tooling to help improve productivity.
+Once you've successfully launched the development environment, you'll be able to take advantage of our developer tooling to help improve productivity and quality.
 
 ### Syntax Tests
 

docs/src/tutorials/json.ipynb

@@ -9,6 +9,18 @@
     "# Using the `json` type"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "62450023",
+   "metadata": {},
+   "source": [
+    "> ⚠️ Note the following before using the `json` type\n",
+    "> - Supported only for MySQL >= 8.0 when [JSON_VALUE](https://dev.mysql.com/doc/refman/8.0/en/json-search-functions.html#function_json-value) introduced.\n",
+    "> - Equivalent Percona is fully-compatible.\n",
+    "> - MariaDB is not supported since [JSON_VALUE](https://mariadb.com/kb/en/json_value/#syntax) does not allow type specification like MySQL's.\n",
+    "> - Not yet supported in DataJoint MATLAB"
+   ]
+  },
   {
    "attachments": {},
    "cell_type": "markdown",
@@ -1046,7 +1058,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3.10.4 64-bit",
    "language": "python",
    "name": "python3"
   },
@@ -1060,11 +1072,11 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.16"
+   "version": "3.10.4"
   },
   "vscode": {
    "interpreter": {
-    "hash": "949777d72b0d2535278d3dc13498b2535136f6dfe0678499012e853ee9abcab1"
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
    }
   }
  },