docs: new documentation

Author: CodeDredd

.gitignore

@@ -11,6 +11,6 @@ phpunit.xml
 phpstan.neon
 testbench.yaml
 vendor
-node_modules
 .php-cs-fixer.cache
 ray.php
+/docs/v3/node_modules/

docs/v2/client/authentication.md

@@ -0,0 +1,49 @@
+# Authentication
+
+You may specify basic authentication credentials using the `withBasicAuth` method, respectively:
+
+    // Basic authentication...
+    $response = Soap::baseWsdl('http://test.com'/v1?wsdl)->withBasicAuth('[email protected]', 'secret')->call(...);
+
+#### Web Service Security (WSS / WSSE)
+
+Internally it is using the [wse-php package of robrichards](https://github.com/robrichards/wse-php) which is a well known library that is used by many developers.
+It also supports not secured Wsse but with token:
+
+    //Not secure
+    $response = Soap::baseWsdl('http://test.com'/v1?wsdl)->withWsse([
+        'userTokenName' => 'username',
+        'userTokenPassword' => 'password',
+    ])->call(...);
+    //Secure
+    $response = Soap::baseWsdl('http://test.com'/v1?wsdl)->withWsse([
+        'privateKeyFile' => 'path/to/privatekey.pem',
+        'publicKeyFile' => 'path/to/publickey.pyb',
+    ])->call(...);
+
+You have following Wsse Options:
+
+    'userTokenName' : string
+    'userTokenPassword' : string
+    'privateKeyFile' : string
+    'publicKeyFile' : string
+    'serverCertificateFile' : string
+    'serverCertificateHasSubjectKeyIdentifier' : boolean
+    'userTokenDigest' : boolean
+    'digitalSignMethod' : string
+    'timestamp' : integer
+    'signAllHeaders' => : boolean
+
+#### Web Service Addressing (WSA)
+
+Like Wss/Wsse it uses the same package:
+
+    $response = Soap::baseWsdl(...)
+        ->withWsa()
+        ->call(...)
+
+### DHL Cis Authentication
+
+DHL uses his own authentication header
+
+    $client = Soap::withCisDHLAuth('user', 'signature')

docs/client/configuration.md renamed to docs/v2/client/configuration.md

@@ -0,0 +1,52 @@
+# Response
+
+## Object
+
+The `call` method returns an instance of `CodeDredd\Soap\Client\Response`, which provides a variety of methods that may be used to inspect the response:
+
+    $response->body() : string;
+    $response->json() : array;
+    $response->status() : int;
+    $response->ok() : bool;
+    $response->successful() : bool;
+    $response->serverError() : bool;
+    $response->clientError() : bool;
+    $response->onError(callable $callback): \CodeDredd\Soap\Client\Response;
+    $response->collect(): \Illuminate\Support\Collection;
+
+The `CodeDredd\Soap\Client\Response` object also implements the PHP `ArrayAccess` interface, allowing you to access your response data directly on the response:
+
+    return Soap::baseWsdl('http://test.com'/v1?wsdl)->call('Get_Users')['name'];
+
+## Error Handling
+
+Unlike Guzzle's default behavior, this SOAP client wrapper does not throw exceptions on client or server errors (`400` and `500` level responses from servers). You may determine if one of these errors was returned using the `successful`, `clientError`, or `serverError` methods:
+
+    // Determine if the status code was >= 200 and < 300...
+    $response->successful();
+
+    // Determine if the response has a 400 level status code...
+    $response->clientError();
+
+    // Determine if the response has a 500 level status code...
+    $response->serverError();
+
+### Throwing Exceptions
+
+If you have a response instance and would like to throw an instance of `CodeDredd\Soap\Exceptions\RequestException` if the response is a client or server error, you may use the `throw` method:
+
+    $response = Soap::baseWsdl(...)->call(...);
+
+    // Throw an exception if a client or server error occurred...
+    $response->throw();
+
+    return $response['user']['id'];
+
+The `CodeDredd\Soap\Exceptions\RequestException` instance has a public `$response` property which will allow you to inspect the returned response.
+
+The `throw` method returns the response instance if no error occurred, allowing you to chain other operations onto the `throw` method:
+
+    return Soap::baseWsdl(...)
+        ->call(...)
+        ->throw()
+        ->json();