diff --git a/features/netsocket/DTLSSocket.h b/features/netsocket/DTLSSocket.h
index d7c8db3de2..4eafbcb2d0 100644
--- a/features/netsocket/DTLSSocket.h
+++ b/features/netsocket/DTLSSocket.h
@@ -1,3 +1,4 @@
+/** @file DTLSSocket.h DTLSSocket */
 /*
  * Copyright (c) 2018 ARM Limited
  * SPDX-License-Identifier: Apache-2.0
@@ -14,6 +15,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/** @addtogroup netsocket
+* @{
+*/
 
 #ifndef DTLSSOCKET_H
 #define DTLSSOCKET_H
@@ -92,3 +96,4 @@ private:
 
 #endif
 #endif
+/** @} */
\ No newline at end of file
diff --git a/features/netsocket/TLSSocket.h b/features/netsocket/TLSSocket.h
index f868865f1d..dcaee7aa5c 100644
--- a/features/netsocket/TLSSocket.h
+++ b/features/netsocket/TLSSocket.h
@@ -1,3 +1,4 @@
+/** @file TLSSocket.h TLSSocket */
 /*
  * Copyright (c) 2018 ARM Limited
  * SPDX-License-Identifier: Apache-2.0
@@ -14,6 +15,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/** @addtogroup netsocket
+* @{
+*/
 
 #ifndef _MBED_HTTPS_TLS_TCP_SOCKET_H_
 #define _MBED_HTTPS_TLS_TCP_SOCKET_H_
@@ -87,3 +91,5 @@ private:
 
 #endif // MBEDTLS_SSL_CLI_C
 #endif // _MBED_HTTPS_TLS_TCP_SOCKET_H_
+
+/** @} */
\ No newline at end of file
diff --git a/features/netsocket/TLSSocketWrapper.h b/features/netsocket/TLSSocketWrapper.h
index 78451a28f4..755608a554 100644
--- a/features/netsocket/TLSSocketWrapper.h
+++ b/features/netsocket/TLSSocketWrapper.h
@@ -1,3 +1,4 @@
+/** @file TLSSocketWrapper.h TLSSocketWrapper */
 /*
  * Copyright (c) 2018 ARM Limited
  * SPDX-License-Identifier: Apache-2.0
@@ -14,6 +15,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/** @addtogroup netsocket
+* @{
+*/
 
 #ifndef _MBED_HTTPS_TLS_SOCKET_WRAPPER_H_
 #define _MBED_HTTPS_TLS_SOCKET_WRAPPER_H_
@@ -186,8 +190,8 @@ protected:
      *  was a first call to Socket::connect() API so that NSAPI_ERROR_INPROGRESS
      *  does not happen twice.
      *
-     *  @parameter first_call is this a first call to Socket::connect() API.
-     *  @return         0 on success, negative error code on failure
+     *  @param        first_call is this a first call to Socket::connect() API.
+     *  @return       0 on success, negative error code on failure
      */
     nsapi_error_t start_handshake(bool first_call);
 
@@ -261,3 +265,4 @@ private:
 
 #endif /* MBEDTLS_SSL_CLI_C */
 #endif // _MBED_HTTPS_TLS_SOCKET_WRAPPER_H_
+/** @} */
\ No newline at end of file