diff --git a/vlib/net/html/README.md b/vlib/net/html/README.md
index 42f725b08e..a92a6e6dc7 100644
--- a/vlib/net/html/README.md
+++ b/vlib/net/html/README.md
@@ -1,118 +1,16 @@
-# V HTML
-
-A HTML parser made in V.
+net/http is an HTML written in pure V.
## Usage
+```v oksyntax
+import net.html
-If the description below isn't enought, please look at the test files.
-
-### Parser
-
-Responsible for read HTML in full strings or splited string and returns all Tag objets of
-it HTML or return a DocumentObjectModel, that will try to find how the HTML Tree is.
-
-#### split_parse(data string)
-This functions is the main function called by parse method to fragment parse your HTML.
-
-#### parse_html(data string, is_file bool)
-This function is called passing a filename or a complete html data string to it.
-
-#### add_code_tag(name string)
-This function is used to add a tag for the parser ignore it's content.
-For example, if you have an html or XML with a custom tag, like `