Comments on packages and public types should be GoDoc friendly

[bufdev]

Package comments always start with "Package name_of_package ...", types are always commented wit the name of the type:

// Foo is a ...
type Foo struct {
}

// Bar does ...
type Bar interface {
}

var (
  // Name is the volume driver name.
  //
  // TODO(osd team): more descriptive names for these variables  
  Name = "btrfs"
)

This will fail golint otherwise.

[jvinod]

+1 and will enforce going forward.

[lpabon]

Closing since it has had no update for more than 6 months. Please reopen if needed.