Try and make the README a bit clearer (#54)

* Try and make the README a bit clearer

* Add link to dummy API config

* Revert

Author: thewilkybarkid

README.md

@@ -8,9 +8,24 @@ Serve content read from a Libero API to the public.
 Getting started
 ---------------
 
-To run a website reading from two content services (`blog-articles` and `scholarly-articles`):
+1. Run `docker-compose down --volumes --remove-orphans && docker-compose up --build`.
 
-1. Create `config/packages/content_page.yaml`:
+2. Open http://localhost:8080/articles/article1 to see the scholarly article `article1` in the `dev` environment.
+
+### Configuration
+
+The `dev` environment reads content from a [Libero dummy API](https://github.com/libero/dummy-api), using the configuration and data in [`.docker/api`](.docker/api).
+
+Running in production
+---------------------
+
+The application is not yet stable, but Docker images are published ([`liberoadmin/browser`](https://hub.docker.com/r/liberoadmin/browser)).
+
+To run an image reading from two content services (`blog-articles` and `scholarly-articles`), you will need the following configuration:
+
+- Set the `API_URI` environment variable to be the root of the Libero API.
+
+- Create `config/packages/content_page.yaml` (either by extending the image or mounting a file):
 
     ```yaml
     content_page:
@@ -23,15 +38,9 @@ To run a website reading from two content services (`blog-articles` and `scholar
                 service: 'scholarly-articles'
     ```
 
-2. Run `docker-compose -f docker-compose.yaml down --v && docker-compose -f docker-compose.yaml up --build`.
-
-    Note the `dev` environment is already preconfigured and can be accessed be running `docker-compose down -v && docker-compose up --build` instead. 
-
-3. Open http://localhost:8080/blog/foo to see the blog post `foo`.
-
 Getting help
 ------------
 
 - Report a bug or request a feature on [GitHub](https://github.com/libero/libero/issues/new/choose).
-- Ask a question on the [Libero Community Slack](https://libero-community.slack.com/).
+- Ask a question on the [Libero Community Slack](https://libero.pub/join-slack).
 - Read the [code of conduct](https://libero.pub/code-of-conduct).