auth: Low-level API for minting delegation tokens.

server/auth/delegation/doc.go

Index: server/auth/delegation/doc.go
diff --git a/server/auth/delegation/doc.go b/server/auth/delegation/doc.go
new file mode 100644
index 0000000000000000000000000000000000000000..441b8eb72676c32181b54c145131f38aecf33a2d
--- /dev/null
+++ b/server/auth/delegation/doc.go
@@ -0,0 +1,14 @@
+// Copyright 2016 The LUCI Authors. All rights reserved.
+// Use of this source code is governed under the Apache License, Version 2.0
+// that can be found in the LICENSE file.
+
+// Package delegation contains low-level API for working with delegation tokens.
+//
+// It provides convenient wrappers around Auth Service API for creating the
+// tokens and related proto messages.
+//
+// If you don't know what it is and how to use it, you probably don't need it.

[iannucci, 2016/08/11 22:52:35]

I dunno about 'how to use it'... wouldn't that advise no one to look at the
docs? :D

Maybe "If you don't know what it is, or why you would use it, you probably...."

[Vadim Sh., 2016/08/11 23:25:37]

Done.

+//
+// Prefer the high-level API in server/auth package, in particular
+// `MintDelegationToken` and `auth.GetRPCTransport(ctx, auth.AsUser)`.
+package delegation