anchor.diff:  * Service Description Type - A number of Definition Languages (DL) have been developed to describe the service. Some of examples are WSDL, WADL and Swagger. In order to consume a decription document it is good to know the type of DL used.
   
   == Proposal
  +
  +=== Single endpoint info
  +
   Kubernetes allows the creation of http://kubernetes.io/v1.0/docs/user-guide/annotations.html[Service Annotations]. Here we propose the use of the following annotations
   
   * 'servicepath' - the path part of the service endpoint url. An example value could be 'quickstart-java-cxf-cdi/cxfcdi',
  
positive.code:     "kind" : "Service",
      "metadata" : {
        "annotations" : {
          "prometheus.io/port" : "9779",
          "protocol" : "REST",
          "servicepath" : "quickstart-java-cxf-cdi/cxfcdi",
          "descriptionpath" : "quickstart-java-cxf-cdi/cxfcdi/swagger.json",
          "prometheus.io/scrape" : "true",
          "descriptiontype" : "SwaggerJSON"
        },
  ...
  ....
  kkk
  
  
  
negative.code: * 'descriptionpath' - the path part of the service description document's endpoint. It is a pretty safe assumption that the service self documents. An example value for a swagger 2.0 document can be 'quickstart-java-cxf-cdi/cxfcdi/swagger.json',
  * 'descriptiontype' - the type of Description Language used. Example values can be 'WSDL', 'WADL', 'SwaggerJSON', 'SwaggerYAML'.
  
  The fragment below is taken from the service section of the kubernetes.json were these annotations are used
  
  .... 
  ...
  