diff --git a/doc/api/http.md b/doc/api/http.md
index 95a9651ff744e2..95bec2b26811fa 100644
--- a/doc/api/http.md
+++ b/doc/api/http.md
@@ -1015,6 +1015,9 @@ it will switch to implicit header mode and flush the implicit headers.
 This sends a chunk of the response body. This method may
 be called multiple times to provide successive parts of the body.
 
+Note that in `http` module, the response body is omitted when the request is a 
+HEAD. Similarly, The `204` and `304` responses MUST NOT include a message body.
+
 `chunk` can be a string or a buffer. If `chunk` is a string,
 the second parameter specifies how to encode it into a byte stream.
 By default the `encoding` is `'utf8'`. `callback` will be called when this chunk
diff --git a/doc/api/url.md b/doc/api/url.md
index 522c5396d900dc..47e3b1865c7043 100644
--- a/doc/api/url.md
+++ b/doc/api/url.md
@@ -235,6 +235,19 @@ url.resolve('http://example.com/', '/one')    // 'http://example.com/one'
 url.resolve('http://example.com/one', '/two') // 'http://example.com/two'
 ```
 
+Note that `url.resolve()` method depends on the protocol given in the `from` parameter. 
+Some protocols like `https`, `file`, `ftp`, `wss` and `gopher` have special cases.
+
+For example:
+
+```js
+url.resolve('https://foo.tld', 'bar')   // 'https://foo.tld/bar'
+url.resolve('wss://foo.tld', 'bar')      // 'wss://bar'
+url.resolve('ftps://foo.tld', 'bar')     // 'ftps://bar'
+```
+
+Although, the uniform behaviour of the method is achieved when the URL ends with a slash.
+
 ## Escaped Characters
 
 URLs are only permitted to contain a certain range of characters. Spaces (`' '`)