From 35f60f6811132ff74a392457c2282cff1e03bf3a Mon Sep 17 00:00:00 2001
From: David Sharnoff <dsharnoff@singlestore.com>
Date: Wed, 29 Jun 2022 15:22:37 -0700
Subject: [PATCH] add some docs to NewOpenIDProvider()

---
 pkg/op/op.go | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/pkg/op/op.go b/pkg/op/op.go
index 0d3bc76..a27d017 100644
--- a/pkg/op/op.go
+++ b/pkg/op/op.go
@@ -117,6 +117,23 @@ type endpoints struct {
 	JwksURI            Endpoint
 }
 
+//NewOpenIDProvider creates a provider. The provider provides (with HttpHandler())
+//a http.Router that handles a suite of endpoints (some paths can be overridden):
+//  /healthz
+//  /ready
+//  /.well-known/openid-configuration
+//  /oauth/token
+//  /oauth/introspect
+//  /callback
+//  /authorize
+//  /userinfo
+//  /revoke
+//  /end_session
+//  /keys
+//This does not include login. Login is handled with a redirect that includes the
+//request ID. The redirect for logins is specified per-client by Client.LoginURL().
+//Successful logins should make the request as authorized and redirect back to to
+//op.AuthCallbackURL(provider) which is probably /callback.
 func NewOpenIDProvider(ctx context.Context, config *Config, storage Storage, opOpts ...Option) (OpenIDProvider, error) {
 	err := ValidateIssuer(config.Issuer)
 	if err != nil {