Add package documentation to certain files

security/s2a/internal/authinfo/authinfo.go

@@ -16,6 +16,10 @@
  *
  */
 
+/*
+Package authinfo provides authentication and authorization information from the
+S2A session result to the gRPC stack.
+*/
 package authinfo
 
 import (

security/s2a/internal/fakehandshaker/main.go

@@ -16,6 +16,7 @@
  *
  */
 
+// The fakehandshaker binary provides a fake handshaker service for S2A.
 package main
 
 import (

security/s2a/internal/handshaker/handshaker.go

@@ -16,6 +16,7 @@
  *
  */
 
+// Package handshaker implements the S2A handshaker service.
 package handshaker
 
 import (

security/s2a/internal/record/internal/aeadcrypter/aeadcrypter.go

@@ -16,6 +16,10 @@
  *
  */
 
+/*
+Package aeadcrypter provides the interface for AEAD Crypter implementations
+used by S2A.
+*/
 package aeadcrypter
 
 // S2AAEADCrypter is the interface for an AEAD cipher used by the S2A record

security/s2a/internal/record/internal/halfconn/halfconn.go

@@ -16,6 +16,10 @@
  *
  */
 
+/*
+Package halfconn implements a half connection for managing one side of a TLS 1.3
+connection.
+*/
 package halfconn
 
 import (

security/s2a/internal/record/record.go

@@ -16,6 +16,7 @@
  *
  */
 
+// Package record implements the TLS 1.3 record protocol.
 package record
 
 import (

security/s2a/s2a.go

@@ -16,6 +16,9 @@
  *
  */
 
+/*
+Package s2a provides the S2A transport credentials used by gRPC.
+*/
 package s2a
 
 import (