Add some more information to the README

Author: Ferruck

README.md

@@ -1,32 +1,47 @@
-# Bob containers example
-
-This repository uses the [basement](https://github.com/BobBuildTool/basement)
-recipes to build a lighttpd container.
+# Bob Containers Example
 
 [![Build Status](https://ci.bobbuildtool.dev/jenkins/buildStatus/icon?job=example-containers-containers__lighttpd)](https://ci.bobbuildtool.dev/jenkins/job/example-containers-containers__lighttpd/)
 
+This repository is meant as an example of how to build a complete Linux image
+with Bob that can be used as-is or with minimal changes for various uses, such
+as a Docker container, as a virtual machine, on a SD card in your single board
+computer or with `systemd-nspawn`.
+
+It uses the [basement](https://github.com/BobBuildTool/basement) recipe layer to
+build a Docker container running lighttpd, with only the necessary dependencies
+installed - in contrast to building such a container on top of a Debian release.
+For more information about recipe layers and Bob's usage in general see [its
+documentation](https://bob-build-tool.readthedocs.io/en/latest/index.html).
+
+If you're interested in building an embedded application using Bob and the
+basement layer, head over to the [embedded
+example](https://github.com/BobBuildTool/bob-example-embedded).
+
 # Prerequisites
 
-* A x86_64 system with the regular development tools installed (gcc, make,
-  perl, ...)
-* Bleeding edge Bob Build Tool (https://github.com/BobBuildTool/bob)
-* Patience
+* A `x86_64` system with the regular development tools installed (GCC, make,
+  Perl, ...)
+* Bleeding edge [Bob Build Tool](https://github.com/BobBuildTool/bob) (see
+  [below](#why-bleeding-edge))
+* Patience :coffee:
 
 # How to build
 
 Clone the recipes and build them with Bob:
 
     $ git clone https://github.com/BobBuildTool/bob-example-containers.git \
 	    --recurse-submodules
+    $ cd bob-example-containers
     $ bob build containers::lighttpd
 
-This recipe builds a minimal container image that has solely lighttpd and the
+These recipes build a minimal container image that has solely lighttpd and the
 required dependencies installed.
 
 # How to use
 
-To use it you have to import it in docker:
+To use it you have to import it in Docker:
 
+    $ # Still in the bob-example-containers directory
     $ tar -C $(bob query-path -f '{dist}' --release containers::lighttpd) -c . \
         | docker import - lighttpd
 
@@ -37,3 +52,20 @@ Now you can serve any host directory with the lighttpd in the image:
         -m /usr/lib/lighttpd
 
 This will expose the lighttpd at port 8080 on your host.
+
+# Contributions
+
+Contributions are welcome in form of feedback, bug reports and code. If you want
+to contribute in the form of code but are unsure about how to do things exactly,
+feel free to open up a pull request and ask for help.
+
+Currently planned extension are:
+
+* [ ] Support generating more image formats
+
+# Why bleeding edge
+
+The example uses Bob recipe layers that aren't currently available within a Bob
+release because one goal of it is testing the new feature intensively. Bob's
+next release will likely include layers so you won't have to install the
+bleeding edge version anymore.