Documentation updates.

README.rst

@@ -96,13 +96,13 @@ The ``collect`` should be used sparingly, as not to burden the server unnecessar
 Python 2, urllib3 and certificate verification
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-An `InsecurePlatformWarning` is issued when using the client in Python 2 (See
+An ``InsecurePlatformWarning`` is issued when using the client in Python 2 (See
 `urllib3 documentation <https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning>`_).
-This can be remedied by installing pyopenssl according to
+This can be remedied by installing ``pyopenssl`` according to
 `this issue <https://github.com/kennethreitz/requests/issues/749>`_ and
 `docstrings in requests <https://github.com/kennethreitz/requests/blob/master/requests/packages/urllib3/contrib/pyopenssl.py>`_.
 
-Optionally, the environment variable `PYBANKID_DISABLE_WARNINGS` can be set to disable these warnings.
+Optionally, the environment variable ``PYBANKID_DISABLE_WARNINGS`` can be set to disable these warnings.
 
 Testing
 -------

bankid/testcert.py

@@ -98,7 +98,7 @@ def split_test_cert_and_key():
                          stderr=subprocess.PIPE)
     p.communicate()
 
-    # Open the newly created PEM certificate in the temporary folder.
+    # Open the newly created PEM certificate and key in the temporary folder.
     with open(cert_conv_tmp_path, 'rt') as f:
         certificate = f.read()
     with open(key_conv_tmp_path, 'rt') as f:

docs/client.rst

@@ -3,7 +3,7 @@
 BankID Client
 =============
 
-
+The client and the transport class using requests.
 
 .. automodule:: bankid.client
    :members:

docs/testcert.rst

@@ -3,6 +3,17 @@
 Test Certificate methods
 ========================
 
+There is a test certificate available on `BankID Technical Information webpage
+<https://www.bankid.com/bankid-i-dina-tjanster/rp-info>`_, which can be used for
+testing authorization and signing. The methods in the :py:mod:`bankid.testcert`
+module fetches that test certificate, splits it into one certificate and one key part and
+converts it from `pxf <https://en.wikipedia.org/wiki/PKCS_12>`_ format to
+`pem <https://en.wikipedia.org/wiki/X.509#Certificate_filename_extensions>`_.
+
+.. note::
+   It also removes the password from the private key in the certificate,
+   which is a requirement for using the PyBankID package in an automated way.
+
 .. automodule:: bankid.testcert
    :members:
 

docs/usage.rst

@@ -86,3 +86,14 @@ with the ``collect`` method using the received ``orderRef``:
                   u'surname': u'Namnsson'}}
 
 The ``collect`` should be used sparingly, as not to burden the server unnecessarily.
+
+Python 2, urllib3 and certificate verification
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+An ``InsecurePlatformWarning`` is issued when using the client in Python 2 (See
+`urllib3 documentation <https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning>`_).
+This can be remedied by installing ``pyopenssl`` according to
+`this issue <https://github.com/kennethreitz/requests/issues/749>`_ and
+`docstrings in requests <https://github.com/kennethreitz/requests/blob/master/requests/packages/urllib3/contrib/pyopenssl.py>`_.
+
+Optionally, the environment variable ``PYBANKID_DISABLE_WARNINGS`` can be set to disable these warnings.