Repo readme update (#185)

* Improve README.md

README.md

@@ -3,16 +3,19 @@
 
 # oscm-rest-api
 This is a RESTful API for the Open Service Catalog Manager.
-It is integrated with Swagger (an implementation of OpenApi standard). You can explore and use the API resources using Swagger-UI which is accessible via /oscm-rest-api context path on the oscm-core https port (default 8081).
-All resources as well as Swagger UI are protected. When visiting the Swagger UI, your browser will ask for authorization. Enter the credentials for the platform administrator.
 
-![Swagger UI endpoint categories view](https://raw.githubusercontent.com/servicecatalog/oscm-rest-api/master/oscm-rest-api-swagger/src/main/resources/swagger-ui-demo.png)
+This API is integrated with Swagger - an implementation of [OpenAPI specification](https://www.openapis.org/). You can explore and use the OSCM API resources via the Swagger UI, which is deployed in the [oscm-core](https://hub.docker.com/r/servicecatalog/oscm-core/) container. A description for installing OSCM on docker can be found [here](https://github.com/servicecatalog/oscm-dockerbuild#setup).
 
-# Prerequisites
-A Linux system with:
+You can access the Swagger UI with the context path **/oscm-rest-api**, by default on the oscm-core HTTPS port 8081. All resources as well as Swagger UI are protected. When visiting the Swagger UI, your browser will ask for authorization. 
+Enter the user key ```1000``` and password for the OSCM platform administrator.
+
+![IMAGE Swagger UI](/swaggerui.png)
 
-* Latest OSCM version installed and running (find the Quickstart instruction)
-* Apache TomEE version >= 7.1.1 in the oscm-core container
+# Prerequisites
+A Linux operating system, with
+* Mininum specification as described [here](https://github.com/servicecatalog/oscm-dockerbuild#prerequisites)
+* Latest OSCM version installed and running (find the [Quickstart instructions](https://github.com/servicecatalog/oscm-dockerbuild#setup))
+* Apache TomEE version >= 7.1.1, which is already included since OSCM v18.1
 
 # Building from source
 To build the REST API:
@@ -23,3 +26,4 @@ To build the REST API:
      From docker host execute: `docker cp oscm-rest-api-uberwar/target/oscm-rest-api.war oscm-core:/opt/apache-tomee/webapps/`
      There is no need to restart the container afterwards. You can view the .war deployment logs in the newest `/logs/juli.log` file in the oscm-core container.
 4. Open the Swagger UI in your client browser on https://FQDN:8081/oscm-rest-api (where FQDN refers to your OSCM fully qualified domain name as configured in your `/docker/var.env` file).
+