Convert docs to Markdown (#6770)

* Convert docs to Markdown

* lint

* update refs

* more update

Author: jtpio

docs/source/config_overview.md

@@ -0,0 +1,63 @@
+(configuration-overview)=
+
+# Configuration Overview
+
+Beyond the default configuration settings, you can configure a rich array of
+options to suit your workflow. Here are areas that are commonly configured
+when using Jupyter Notebook:
+
+> - {ref}`Jupyter's common configuration system <configure-common>`
+> - {ref}`Jupyter Server <configure-jupyter-server>`
+> - {ref}`Notebook extensions <configure-nbextensions>`
+
+Let's look at highlights of each area.
+
+(configure-common)=
+
+## Jupyter's Common Configuration system
+
+Jupyter applications, from the Notebook to JupyterHub to nbgrader, share a
+common configuration system. The process for creating a configuration file
+and editing settings is similar for all the Jupyter applications.
+
+> - [Jupyter’s Common Configuration Approach](https://jupyter.readthedocs.io/en/latest/use/config.html)
+> - [Common Directories and File Locations](https://jupyter.readthedocs.io/en/latest/use/jupyter-directories.html)
+> - [Language kernels](https://jupyter.readthedocs.io/en/latest/projects/kernels.html)
+> - [traitlets](https://traitlets.readthedocs.io/en/latest/config.html#module-traitlets.config)
+>   provide a low-level architecture for configuration.
+
+(configure-jupyter-server)=
+
+## Jupyter server
+
+The Jupyter Server runs the language kernel and communicates with the
+front-end Notebook client (i.e. the familiar notebook interface).
+
+> - Configuring the Jupyter Server
+>
+>   > To create a `jupyter_server_config.py` file in the `.jupyter`
+>   > directory, with all the defaults commented out, use the following
+>   > command:
+>   >
+>   > ```
+>   > $ jupyter server --generate-config
+>   > ```
+>
+> - [Running a Jupyter Server](https://jupyter-server.readthedocs.io/en/stable/operators/public-server.html)
+>
+> - Related: [Configuring a language kernel](https://ipython.readthedocs.io/en/latest/install/kernel_install.html)
+>   to run in the Jupyter Server enables your server to run other languages, like R or Julia.
+
+(configure-nbextensions)=
+
+## Notebook extensions
+
+The Notebook frontend can be extending with JupyterLab extensions.
+
+See the {ref}`Frontend Extension Guide <frontend-extensions>` for more information.
+
+[Security in Jupyter notebooks:](https://jupyter-server.readthedocs.io/en/stable/operators/security.html)
+Since security policies vary from organization to organization, we encourage you to
+consult with your security team on settings that would be best for your use
+cases. Our documentation offers some responsible security practices, and we
+recommend becoming familiar with the practices.

docs/source/config_overview.rst

@@ -0,0 +1,10 @@
+# Configuration
+
+```{toctree}
+:caption: Configuration
+:maxdepth: 1
+
+config_overview
+Security <https://jupyter-server.readthedocs.io/en/stable/operators/security.html>
+extending/index.rst
+```

docs/source/configuration.md

@@ -0,0 +1,9 @@
+# Contributor
+
+```{toctree}
+:caption: Contributor Documentation
+:maxdepth: 1
+
+contributing
+development_faq
+```

docs/source/configuration.rst

@@ -0,0 +1,9 @@
+(development-faq)=
+
+# Developer FAQ
+
+1. How do I install a prerelease version such as a beta or release candidate?
+
+```bash
+python -m pip install notebook --pre --upgrade
+```

docs/source/contributor.md

@@ -1,8 +1,6 @@
-.. _frontend_extensions:
+(frontend-extensions)=
 
-===========================
-Custom front-end extensions
-===========================
+# Custom front-end extensions
 
 This describes the basic steps to write a TypeScript extension for the Jupyter
 notebook front-end. This allows you to customize the behaviour of the various
@@ -15,5 +13,5 @@ This means Notebook v7 is able to reuse many of the existing extensions from the
 
 If you would like to develop a prebuilt extension for Notebook v7, check out:
 
-- `JupyterLab Extension Tutorial <https://jupyterlab.readthedocs.io/en/latest/extension/extension_tutorial.html>`_: A tutorial to learn how to make a simple JupyterLab extension.
-- The `JupyterLab Extension Examples Repository <https://github.com/jupyterlab/extension-examples>`_: A short tutorial series to learn how to develop extensions for JupyterLab by example.
+- [JupyterLab Extension Tutorial](https://jupyterlab.readthedocs.io/en/latest/extension/extension_tutorial.html): A tutorial to learn how to make a simple JupyterLab extension.
+- The [JupyterLab Extension Examples Repository](https://github.com/jupyterlab/extension-examples): A short tutorial series to learn how to develop extensions for JupyterLab by example.

docs/source/contributor.rst

@@ -0,0 +1,12 @@
+# Extending the Notebook
+
+Certain subsystems of the notebook server are designed to be extended or
+overridden by users. These documents explain these systems, and show how to
+override the notebook's defaults with your own custom behavior.
+
+```{toctree}
+:maxdepth: 2
+
+Extending the Jupyter Server <https://jupyter-server.readthedocs.io/en/stable/developers/index.html>
+frontend_extensions
+```