Godoc for middleware packages and server package

middleware/extensionless/extensionless.go

@@ -1,4 +1,4 @@
-// Extensionless is middleware for clean URLs. A root path is
+// Package extensionless is middleware for clean URLs. A root path is
 // passed in as well as possible extensions to add, internally,
 // to paths requested. The first path+ext that matches a resource
 // that exists will be used.

middleware/gzip/gzip.go

@@ -1,3 +1,5 @@
+// Package gzip provides a simple middleware layer that performs
+// gzip compression on the response.
 package gzip
 
 import (

middleware/headers/headers.go

@@ -1,3 +1,6 @@
+// Package headers provides middleware that appends headers to
+// requests based on a set of configuration rules that define
+// which routes receive which headers.
 package headers
 
 import (

middleware/log/log.go

@@ -1,3 +1,4 @@
+// Package log implements basic but useful request logging middleware.
 package log
 
 import (

middleware/proxy/proxy.go

@@ -1,4 +1,4 @@
-// Proxy is middleware that proxies requests.
+// Package proxy is middleware that proxies requests.
 package proxy
 
 import (

middleware/redirect/redirect.go

@@ -1,4 +1,4 @@
-// Redirect is middleware for redirecting certain requests
+// Package redirect is middleware for redirecting certain requests
 // to other locations.
 package redirect
 

server/server.go

@@ -1,7 +1,6 @@
-// Server implements a configurable, general-purpose web server. It
-// relies on configurations obtained from the adjacent config package
-// and can execute middleware as defined by the adjacent middleware
-// package.
+// Package server implements a configurable, general-purpose web server.
+// It relies on configurations obtained from the adjacent config package
+// and can execute middleware as defined by the adjacent middleware package.
 package server
 
 import (