diff --git a/docs/library/usocket.rst b/docs/library/usocket.rst
index dd0f5708ba..71deaebc41 100644
--- a/docs/library/usocket.rst
+++ b/docs/library/usocket.rst
@@ -41,18 +41,6 @@ Functions
 
    Create a new socket using the given address family, socket type and protocol number.
 
-    .. only:: port_wipy
-
-        .. note::
-
-           SSL sockets need to be created the following way before wrapping them with 
-           ``ssl.wrap_socket``::
-
-              import socket
-              import ssl
-              s = socket(socket.AF_INET, socket.SOCK_STREAM, socket.IPPROTO_SEC)
-              ss = ssl.wrap_socket(s)
-
 .. function:: socket.getaddrinfo(host, port)
 
    Translate the host/port argument into a sequence of 5-tuples that contain all the 
diff --git a/docs/wipy/general.rst b/docs/wipy/general.rst
index d7b35cc4ed..9b3f54df23 100644
--- a/docs/wipy/general.rst
+++ b/docs/wipy/general.rst
@@ -239,3 +239,17 @@ Additional Pin methods:
 
    Returns a list of the alternate functions supported by the pin. List items are
    a tuple of the form: ``('ALT_FUN_NAME', ALT_FUN_INDEX)``
+
+Known issues
+------------
+
+Incompatible way to create SSL sockets
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+SSL sockets need to be created the following way before wrapping them with.
+``ssl.wrap_socket``::
+
+  import socket
+  import ssl
+  s = socket(socket.AF_INET, socket.SOCK_STREAM, socket.IPPROTO_SEC)
+  ss = ssl.wrap_socket(s)