inital kernel content

docs/intro_kernels.md

@@ -0,0 +1,19 @@
+---
+id: intro-kernels
+title: Introducing Kernels 
+---
+
+
+# Introducing Kernels
+
+ Kernels are tools to run code. Kernels receive messages from the front end that contain a user's code and execute the code.  The kernel then sends messages that contain the result of the executed code back to the front end.  Messages are formatted as JSONs and sent using [ZeroMQ](http://zguide.zeromq.org/page:all#ZeroMQ-in-a-Hundred-Words).
+
+![](http://ipython.readthedocs.io/en/stable/_images/other_kernels.png)
+
+
+ IPython provides wrappers to execute code that
+ have been used to develop kernels across [over 100 languages](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels). Notable examples of community-developed kernels include [xeus for C++](https://github.com/QuantStack/xeus-cling), [IJavascript](https://github.com/n-riesco/ijavascript), [IHaskell](https://github.com/gibiansky/IHaskell), [Igo](https://github.com/yunabe/lgo), [IJulia](https://github.com/JuliaLang/IJulia.jl), [IRKernel](https://github.com/IRkernel/IRkernel), and [Calysto for Octave](https://github.com/Calysto/octave_kernel).
+
+ To learn more about creating your own Jupyter Kernel, you may learn more at [Making Kernels for Jupyter](http://jupyter-client.readthedocs.io/en/latest/kernels.html).  An simple example kernel
+ is at [dsblank/simple_kernel](https://github.com/dsblank/simple_kernel) on GitHub.
+ If you do create a new kernel, [please add it to our list of kernels](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels)!

docs/using_kernels.md

@@ -0,0 +1,57 @@
+---
+id: using-kernels
+title: Using Kernels 
+---
+
+# Using Kernels
+
+Kernels are installed either by installing the kernel directly or adding the
+kernel with [ipykernel](https://github.com/ipython/ipykernel).  Many [community-developed](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels) kernels will include installation instructions in their README.md. Kernels are managed with ipykernel.
+
+To install ipykernel with pip call:
+
+```
+pip install ipykernel
+```
+
+or with conda
+
+```
+conda install ipykernel
+```
+
+To see what kernels you have already installed:
+
+```
+jupyter kernelspec list
+```
+
+Python environments are manually added through ipykernel. To add a Python
+environment, ipykernel must be installed in the environment. To add a kernel
+with ipykernel that is made with a configuration file, e.g. `requirements.txt`
+or `environment.yml`, you will need to install ipykernel into the environment
+and install the kernel while the environment is activated.
+
+
+Using pip:
+
+```
+python -m pip install ipykernel virtualenv
+python -m ipykernel install
+python -m virtualenv myenv
+source myenv/bin/activate
+pip install ipykernel
+pip install -r requirements.txt
+python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
+```
+
+Using conda:
+
+```
+conda install ipykernel
+python -m ipykernel install
+conda env create -f environment.yml
+source activate myenv
+conda install ipykernel
+python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
+```

website/sidebars.json

@@ -7,7 +7,8 @@
       "components-nteract"
     ],
     "Concepts": [
-      "concepts"
+      "intro-kernels",
+      "using-kernels"
     ],
     "Contributing": [
       "design-software",
@@ -16,4 +17,4 @@
       "docs-deploy"
     ]
   }
-}
+}