diff --git a/pkg/volume/aws_ebs/doc.go b/pkg/volume/aws_ebs/doc.go
new file mode 100644
index 0000000000..09c41729f2
--- /dev/null
+++ b/pkg/volume/aws_ebs/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package aws_ebs contains the internal representation of AWS Elastic
+// Block Store volumes.
+package aws_ebs
diff --git a/pkg/volume/empty_dir/doc.go b/pkg/volume/empty_dir/doc.go
new file mode 100644
index 0000000000..143ed0ec35
--- /dev/null
+++ b/pkg/volume/empty_dir/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package empty_dir contains the internal representation of emptyDir
+// volumes.
+package empty_dir
diff --git a/pkg/volume/gce_pd/doc.go b/pkg/volume/gce_pd/doc.go
new file mode 100644
index 0000000000..7d9f99f010
--- /dev/null
+++ b/pkg/volume/gce_pd/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package gce_pd contains the internal representation of GCE PersistentDisk
+// volumes.
+package gce_pd
diff --git a/pkg/volume/git_repo/doc.go b/pkg/volume/git_repo/doc.go
new file mode 100644
index 0000000000..07ec8382a0
--- /dev/null
+++ b/pkg/volume/git_repo/doc.go
@@ -0,0 +1,18 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package git_repo contains the internal representation of git repo volumes.
+package git_repo
diff --git a/pkg/volume/glusterfs/doc.go b/pkg/volume/glusterfs/doc.go
new file mode 100644
index 0000000000..7b910e5927
--- /dev/null
+++ b/pkg/volume/glusterfs/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package glusterfs contains the internal representation of glusterfs
+// volumes.
+package glusterfs
diff --git a/pkg/volume/host_path/doc.go b/pkg/volume/host_path/doc.go
new file mode 100644
index 0000000000..76ab89d0a3
--- /dev/null
+++ b/pkg/volume/host_path/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package host_path contains the internal representation of hostPath
+// volumes.
+package host_path
diff --git a/pkg/volume/iscsi/doc.go b/pkg/volume/iscsi/doc.go
new file mode 100644
index 0000000000..d9d146a108
--- /dev/null
+++ b/pkg/volume/iscsi/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package iscsi contains the internal representation of Internet Small
+// Computer System Interface (iSCSI) volumes.
+package iscsi
diff --git a/pkg/volume/nfs/doc.go b/pkg/volume/nfs/doc.go
new file mode 100644
index 0000000000..a735737346
--- /dev/null
+++ b/pkg/volume/nfs/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package nfs contains the internal representation of network file system
+// (NFS) volumes.
+package nfs
diff --git a/pkg/volume/persistent_claim/doc.go b/pkg/volume/persistent_claim/doc.go
new file mode 100644
index 0000000000..fc1335a8ba
--- /dev/null
+++ b/pkg/volume/persistent_claim/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package persistent_claim contains the internal representation of persistent
+// volume claims.
+package persistent_claim
diff --git a/pkg/volume/rbd/doc.go b/pkg/volume/rbd/doc.go
new file mode 100644
index 0000000000..e9220fb892
--- /dev/null
+++ b/pkg/volume/rbd/doc.go
@@ -0,0 +1,19 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package rbd contains the internal representation of Rados Block Store (Ceph)
+// volumes.
+package rbd
diff --git a/pkg/volume/secret/doc.go b/pkg/volume/secret/doc.go
new file mode 100644
index 0000000000..99b0964758
--- /dev/null
+++ b/pkg/volume/secret/doc.go
@@ -0,0 +1,18 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package secret contains the internal representation of secret volumes.
+package secret