update README

README.rst

@@ -1,10 +1,18 @@
 PythonHere
 ==========
 
+https://img.shields.io/pypi/status/pythonhere
+
 .. start-badges
+.. image:: https://img.shields.io/docker/v/herethere/pythonhere?color=%23FFD43B&label=Docker%20Image
+    :target: https://pypi.python.org/pypi/pythonhere
+    :alt: Status
 .. image:: https://img.shields.io/pypi/v/pythonhere.svg
     :target: https://pypi.python.org/pypi/pythonhere
     :alt: Latest version on PyPi
+.. image:: https://img.shields.io/docker/v/herethere/pythonhere?color=%23FFD43B&label=Docker%20Image
+   :target: https://hub.docker.com/r/herethere/pythonhere
+   :alt: Docker Image Version (latest by date)
 .. image:: https://img.shields.io/pypi/pyversions/pythonhere.svg
     :target: https://pypi.python.org/pypi/pythonhere
     :alt: Supported Python versions
@@ -16,4 +24,52 @@ PythonHere
     :alt: Code coverage Status
 .. end-badges
 
-Here is the Kivy based app to run code from the Jupyter magic %there.
+`Here` is the `Kivy <https://kivy.org>`_ based app to run Python code from the `Jupyter <https://jupyter.org/>`_ magic %there.
+
+- `Here` is a server part with the GUI interface. It could be Android, Raspberry Pi, some other remote device that being debugged.
+- And `%there` is a client - Jupyter magic command to run code interactively on remote device.
+
+
+Install on Android
+------------------
+
+Ready-to-use `PythonHere` APKs are available in the `Releases <https://github.com/b3b/pythonhere/releases>`_ section.
+
+For a list of installed Python packages, see: `buildozer.spec <./buildozer.spec>`_.
+
+
+Quick Start with Docker
+-----------------------
+
+Docker image is based on `Jupyter Docker Stacks <https://jupyter-docker-stacks.readthedocs.io/en/latest/>`_, and includes installed `PythonHere` with usage examples.
+
+Example command to start the Docker container::
+
+    docker run \
+           --rm \
+           -p 8888:8888 \
+           -v "$(pwd)/work":/home/jovyan/work \
+           herethere/pythonhere:latest
+
+
+Command will expose the Jupyter Notebook server on host port 8888. Jupyter logs appear in the terminal and include an URL to the notebook server: http://127.0.0.1:8888/?token-... . Visiting this URL in a browser loads the Jupyter Notebook dashboard page.
+
+Files from the directory **work** inside container, will be available in the host directory with the same name: **work**.
+
+
+Run with Docker Compose
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Commands to run with Docker Compose::
+
+  cp docker-compose.yml.tmpl docker-compose.yml
+  docker-compose up
+
+
+Related resources
+-----------------
+
+* `Kivy Remote Shell <https://github.com/kivy/kivy-remote-shell>`_ : Remote SSH+Python interactive shell application
+* `herethere <https://github.com/b3b/herethere>`_ : Library for interactive code execution, based on AsyncSSH
+* `AsyncSSH <https://github.com/ronf/asyncssh>`_ : Asynchronous SSH for Python
+* `Buildozer action <https://github.com/ArtemSBulgakov/buildozer-action>`_ : GitHub action that is used to build Android APK with `Buildozer <https://github.com/kivy/buildozer>`_

docker-compose.yml.tmpl

@@ -6,7 +6,7 @@ services:
     image: herethere/pythonhere:latest
     # build: .
     ports:
-      - 8889:8888
+      - 8888:8888
     # Uncomment and fill in environment, to override values from there.env config
     # environment:
     #   - THERE_HOST=

examples/Getting_started.md

@@ -30,7 +30,7 @@ from kivy import platform
 print("Hello from", platform)
 ```
 
-#### Use widgets
+#### Use Kivy widgets
 
 ```python
 %%there
@@ -40,7 +40,7 @@ from kivy.uix.label import Label
 root.clear_widgets()  # Remove all current childrens
 
 # And add the new one
-widget = Label(text="Kivy", font_size="80sp")
+widget = Label(text="Kivy", font_size="50sp")
 root.add_widget(widget)
 ```