Version number bump to 1.0.0, move docker doc from package descriptio…

…n to atest/docker/DOCKER.md

Browser/version.py

@@ -1 +1 @@
-VERSION = "0.16.0"
+VERSION = "1.0.0"

README.md

@@ -22,7 +22,7 @@ Only Python 3.7 or later is supported.
 2. Install robotframework-browser from the commandline: `pip install robotframework-browser`
 3. Install the node dependencies: run `rfbrowser init` in your shell
 
-Or use the [docker images](https://github.com/MarketSquare/robotframework-browser/packages).
+Or use the [docker images](https://github.com/MarketSquare/robotframework-browser/packages). Documented at [DOCKER.md](https://github.com/MarketSquare/robotframework-browser/blob/master/atest/docker/DOCKER.md).
 
 # Examples
 

atest/docker/DOCKER.md

@@ -4,3 +4,23 @@ Dockerfile and Dockerfile.playwright20.04 are used for our own CI and docker ima
 
 Dockerfile.latest_release is used as the base to build our published docker images. 
 See [packages](https://github.com/MarketSquare/robotframework-browser/packages) for latest released docker image.
+
+
+Our published Dockerfile can be used as a base for running your own test suites inside docker.
+
+The image comes with latest robotframework-browser and robotframework, and with pre-initialized browsers and other dependencies for running headful tests in the container.
+
+Example usage:
+``` bash
+docker run --rm \
+  -v $(pwd)/atest/test/:/test \
+    docker.pkg.github.com/marketsquare/robotframework-browser/rfbrowser-stable:1.0.0 \
+      bash -c "robot --outputdir /test/output /test"
+      ```
+
+      `docker run -v` is used to mount the directory containing tests on the supervising machine. In this example robot output will also be output inside the test directory
+
+
+When testing with chrome we recommend downloading a copy of `chrome.json` security settings and using the following docker run flags ```--ipc=host --security-opt seccomp=chrome.json``` for best compatibility. [Explanations and the chrome.json can be found here](https://github.com/microsoft/playwright/tree/master/docs/docker#run-the-image)
+
+All dependencies are installed to support running tests as `pwuser` in the docker image. Running tests as root or other non `pwuser` can cause problems.