changing doc format and HTML literals

site/doc/pages/socket_close.txt

@@ -4,12 +4,15 @@ void socket_close(u64 sockfd)
 :params
 sockfd : socket handle
 
-:desc
-Closes an existing socket connection.
-
 :see
 >socket
 
-:related
-**PHP:** PHP sockets and stream APIs like `socket_connect()`, `fread()`, `fwrite()`, and stream clients
-**JavaScript / Node.js:** Node `net.Socket` connect, read, write, and close operations
+:content
+Closes an existing socket connection.
+
+Use this when you are done with a socket opened through `socket_connect()`.
+
+Related:
+
+- PHP: PHP sockets and stream APIs like `socket_connect()`, `fread()`, `fwrite()`, and stream clients
+- JavaScript / Node.js: Node `net.Socket` connect, read, write, and close operations