all: add basic docs

carddav/carddav.go

@@ -1,3 +1,6 @@
+// Package carddav provides a client and server CardDAV implementation.
+//
+// CardDAV is defined in RFC 6352.
 package carddav
 
 import (

carddav/client.go

@@ -45,6 +45,7 @@ func Discover(domain string) (string, error) {
 	return u.String(), nil
 }
 
+// Client provides access to a remote CardDAV server.
 type Client struct {
 	*webdav.Client
 

carddav/server.go

@@ -11,6 +11,7 @@ import (
 
 // TODO: add support for multiple address books
 
+// Backend is a CardDAV server backend.
 type Backend interface {
 	AddressBook() (*AddressBook, error)
 	GetAddressObject(href string) (*AddressObject, error)
@@ -18,10 +19,13 @@ type Backend interface {
 	QueryAddressObjects(query *AddressBookQuery) ([]AddressObject, error)
 }
 
+// Handler handles CardDAV HTTP requests. It can be used to create a CardDAV
+// server.
 type Handler struct {
 	Backend Backend
 }
 
+// ServeHTTP implements http.Handler.
 func (h *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	if h.Backend == nil {
 		http.Error(w, "carddav: no backend available", http.StatusInternalServerError)