From 12034bd13f9d91cff0ac8861b9a40f478d447eb3 Mon Sep 17 00:00:00 2001
From: James M Snell <jasnell@gmail.com>
Date: Fri, 10 Aug 2018 11:49:00 -0700
Subject: [PATCH] doc: clarify http2 docs around class exports

Fixes: https://github.com/nodejs/node/issues/21434
---
 doc/api/http2.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/api/http2.md b/doc/api/http2.md
index d99052003a0c65..4d56b61839c227 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -108,6 +108,11 @@ have occasion to work with the `Http2Session` object directly, with most
 actions typically taken through interactions with either the `Http2Server` or
 `Http2Stream` objects.
 
+User code will not create `Http2Session` instances directly. Server-side
+`Http2Session` instances are created by the `Http2Server` instance when a
+new HTTP/2 connection is received. Client-side `Http2Session` instances are
+created using the `http2.connect()` method.
+
 #### `Http2Session` and Sockets
 
 Every `Http2Session` instance is associated with exactly one [`net.Socket`][] or
@@ -1510,6 +1515,10 @@ added: v8.4.0
 
 * Extends: {net.Server}
 
+Instances of `Http2Server` are created using the `http2.createServer()`
+function. The `Http2Server` class is not exported directly by the `http2`
+module.
+
 #### Event: 'checkContinue'
 <!-- YAML
 added: v8.5.0
@@ -1617,6 +1626,10 @@ added: v8.4.0
 
 * Extends: {tls.Server}
 
+Instances of `Http2SecureServer` are created using the
+`http2.createSecureServer()` function. The `Http2SecureServer` class is not
+exported directly by the `http2` module.
+
 #### Event: 'checkContinue'
 <!-- YAML
 added: v8.5.0