docs: public static ClientBuilder bluemix(String vcapServices, String serviceName, String instanceName) {
          if (vcapServices == null) {
              throw new IllegalArgumentException("The vcapServices JSON information was null.");
          }
  
          if (serviceName == null) {
              throw new IllegalArgumentException("No Cloudant services information present.");
          }
  
          JsonObject obj;
          try {
               obj = (JsonObject) new JsonParser().parse(vcapServices);
          } catch (JsonParseException e) {
              throw new IllegalArgumentException("The vcapServices was not valid JSON.", e);
          }
  
          Gson gson = new GsonBuilder().create();
          List<CloudFoundryService> cloudantServices = null;
  
          JsonElement service = obj.get(serviceName);
          if (service != null) {
              Type listType = new TypeToken<ArrayList<CloudFoundryService>>(){}.getType();
              cloudantServices = gson.fromJson(service, listType);
          }
  
          if (cloudantServices == null || cloudantServices.size() == 0) {
              throw new IllegalArgumentException("No Cloudant services information present.");
          }
  
          if (instanceName == null) {
              if (cloudantServices.size() == 1) {
                  CloudFoundryService cloudantService = cloudantServices.get(0);
                  return vcapClientBuilder(cloudantService);
              } else {
                  throw new IllegalArgumentException("Multiple Cloudant service instances present. " +
                          "A service instance name must be specified.");
              }
          }
  
          for (CloudFoundryService cloudantService : cloudantServices) {
              if (instanceName.equals(cloudantService.name)) {
                  return vcapClientBuilder(cloudantService);
              }
          }
  
          throw new IllegalArgumentException(
                  String.format("Cloudant service instance matching name %s was not found.", instanceName)
          );
      }