diff --git a/stdlib/alpine/alpine.cue b/stdlib/alpine/alpine.cue
index a3013780..071c8f20 100644
--- a/stdlib/alpine/alpine.cue
+++ b/stdlib/alpine/alpine.cue
@@ -1,3 +1,4 @@
+// Base package for Alpine Linux
 package alpine
 
 import (
@@ -6,6 +7,7 @@ import (
 
 let defaultVersion = "3.13.5@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f"
 
+// Base image for Alpine Linux
 #Image: {
 	package: [string]: true | false | string
 	version: string | *defaultVersion
diff --git a/stdlib/aws/aws.cue b/stdlib/aws/aws.cue
index d48e1d7d..91648e54 100644
--- a/stdlib/aws/aws.cue
+++ b/stdlib/aws/aws.cue
@@ -1,3 +1,4 @@
+// AWS base package
 package aws
 
 import (
@@ -6,7 +7,7 @@ import (
 	"dagger.io/alpine"
 )
 
-// Base AWS Config
+// AWS Config shared by all AWS packages
 #Config: {
 	// AWS region
 	region: string @dagger(input)
diff --git a/stdlib/aws/cloudformation/cloudformation.cue b/stdlib/aws/cloudformation/cloudformation.cue
index c2175f33..17c0ece9 100644
--- a/stdlib/aws/cloudformation/cloudformation.cue
+++ b/stdlib/aws/cloudformation/cloudformation.cue
@@ -1,3 +1,4 @@
+// AWS Cloud Formation
 package cloudformation
 
 import (
diff --git a/stdlib/aws/ecr/ecr.cue b/stdlib/aws/ecr/ecr.cue
index 267fceab..cf2cd5a2 100644
--- a/stdlib/aws/ecr/ecr.cue
+++ b/stdlib/aws/ecr/ecr.cue
@@ -1,3 +1,4 @@
+// Amazon Elastic Container Registry (ECR)
 package ecr
 
 import (
diff --git a/stdlib/aws/ecs/run-task.cue b/stdlib/aws/ecs/run-task.cue
index c86907eb..3e6e0b0e 100644
--- a/stdlib/aws/ecs/run-task.cue
+++ b/stdlib/aws/ecs/run-task.cue
@@ -1,10 +1,11 @@
+// AWS Elastic Container Service (ECS)
 package ecs
 
 import (
 	"dagger.io/aws"
 )
 
-// RunTask implement ecs run-task
+// RunTask implements ecs run-task for running a single container on ECS
 #RunTask: {
 
 	// AWS Config
diff --git a/stdlib/aws/eks/eks.cue b/stdlib/aws/eks/eks.cue
index 150fe5f8..c7be43ec 100644
--- a/stdlib/aws/eks/eks.cue
+++ b/stdlib/aws/eks/eks.cue
@@ -1,3 +1,4 @@
+// AWS Elastic Kubernetes Service (EKS)
 package eks
 
 import (
diff --git a/stdlib/aws/elb/elb.cue b/stdlib/aws/elb/elb.cue
index 6d29e1b6..5c26099e 100644
--- a/stdlib/aws/elb/elb.cue
+++ b/stdlib/aws/elb/elb.cue
@@ -1,3 +1,4 @@
+// AWS Elastic Load Balancer (ELBv2)
 package elb
 
 import (
@@ -5,7 +6,7 @@ import (
 	"dagger.io/aws"
 )
 
-// Returns a non-taken rule priority (randomized)
+// Returns an unused rule priority (randomized in available range)
 #RandomRulePriority: {
 	// AWS Config
 	config: aws.#Config
diff --git a/stdlib/aws/rds/rds.cue b/stdlib/aws/rds/rds.cue
index 484d482b..9145c308 100644
--- a/stdlib/aws/rds/rds.cue
+++ b/stdlib/aws/rds/rds.cue
@@ -1,3 +1,4 @@
+// AWS Relational Database Service (RDS)
 package rds
 
 import (
@@ -6,6 +7,7 @@ import (
 	"dagger.io/aws"
 )
 
+// Creates a new Database on an existing RDS Instance
 #CreateDB: {
 	// AWS Config
 	config: aws.#Config
@@ -19,6 +21,7 @@ import (
 	// ARN of the database secret (for connecting via rds api)
 	secretArn: string @dagger(input)
 
+	// Database type MySQL or PostgreSQL (Aurora Serverless only)
 	dbType: "mysql" | "postgres" @dagger(input)
 
 	// Name of the DB created
@@ -79,6 +82,7 @@ import (
 	}
 }
 
+// Creates a new user credentials on an existing RDS Instance
 #CreateUser: {
 	// AWS Config
 	config: aws.#Config
@@ -95,8 +99,10 @@ import (
 	// ARN of the database secret (for connecting via rds api)
 	secretArn: string @dagger(input)
 
+	// Name of the database to grants access to
 	grantDatabase: string | *"" @dagger(input)
 
+	// Database type MySQL or PostgreSQL (Aurora Serverless only)
 	dbType: "mysql" | "postgres" @dagger(input)
 
 	// Outputed username
@@ -185,6 +191,7 @@ import (
 	}
 }
 
+// Fetches information on an existing RDS Instance
 #Instance: {
 	// AWS Config
 	config: aws.#Config
diff --git a/stdlib/aws/s3/s3.cue b/stdlib/aws/s3/s3.cue
index 99e8a20e..e4fa19ed 100644
--- a/stdlib/aws/s3/s3.cue
+++ b/stdlib/aws/s3/s3.cue
@@ -1,3 +1,4 @@
+// AWS Simple Storage Service
 package s3
 
 import (
@@ -6,7 +7,7 @@ import (
 	"dagger.io/aws"
 )
 
-// S3 file or Directory upload
+// S3 Bucket upload (file or directory)
 #Put: {
 
 	// AWS Config
@@ -91,7 +92,7 @@ import (
 	}
 }
 
-// S3 Sync
+// S3 Bucket sync
 #Sync: {
 	// AWS Config
 	config: aws.#Config
diff --git a/stdlib/dagger/dagger.cue b/stdlib/dagger/dagger.cue
index e7afc6d5..8dc76711 100644
--- a/stdlib/dagger/dagger.cue
+++ b/stdlib/dagger/dagger.cue
@@ -6,7 +6,6 @@ import (
 
 // An artifact such as source code checkout, container image, binary archive...
 // May be passed as user input, or computed by a buildkit pipeline
-
 #Artifact: {
 	@dagger(artifact)
 	#up: [...op.#Op]
diff --git a/stdlib/docker/docker.cue b/stdlib/docker/docker.cue
index 9d7bbdb2..6652d5ed 100644
--- a/stdlib/docker/docker.cue
+++ b/stdlib/docker/docker.cue
@@ -1,3 +1,4 @@
+// Docker container operations
 package docker
 
 import (
@@ -102,7 +103,10 @@ import (
 // Build a Docker image from the provided Dockerfile contents
 // FIXME: incorporate into #Build
 #ImageFromDockerfile: {
+	// Dockerfile passed as a string
 	dockerfile: string           @dagger(input)
+
+	// Build context
 	context:    dagger.#Artifact @dagger(input)
 
 	#up: [
diff --git a/stdlib/gcp/gcp.cue b/stdlib/gcp/gcp.cue
index 45f79624..ea0e055e 100644
--- a/stdlib/gcp/gcp.cue
+++ b/stdlib/gcp/gcp.cue
@@ -1,3 +1,4 @@
+// Google Cloud Platform
 package gcp
 
 import (
diff --git a/stdlib/gcp/gcr/gcr.cue b/stdlib/gcp/gcr/gcr.cue
index aebc1149..f3381a9d 100644
--- a/stdlib/gcp/gcr/gcr.cue
+++ b/stdlib/gcp/gcr/gcr.cue
@@ -1,3 +1,4 @@
+// Google Container Registry
 package gcr
 
 import (
diff --git a/stdlib/gcp/gke/gke.cue b/stdlib/gcp/gke/gke.cue
index 69438fea..6ded54f0 100644
--- a/stdlib/gcp/gke/gke.cue
+++ b/stdlib/gcp/gke/gke.cue
@@ -1,3 +1,4 @@
+// Google Kubernetes Engine
 package gke
 
 import (
diff --git a/stdlib/git/git.cue b/stdlib/git/git.cue
index f4eb40fe..b9b8e588 100644
--- a/stdlib/git/git.cue
+++ b/stdlib/git/git.cue
@@ -1,3 +1,4 @@
+// Git operations
 package git
 
 import (
@@ -35,7 +36,11 @@ import (
 
 // Get the name of the current checked out branch or tag
 #CurrentBranch: {
+
+	// Git repository
 	repository: dagger.#Artifact @dagger(input)
+
+	// Git branch name
 	name: {
 		string
 		@dagger(output)
@@ -74,7 +79,11 @@ import (
 
 // List tags of a repository
 #Tags: {
+
+	// Git repository
 	repository: dagger.#Artifact @dagger(input)
+
+	// Repository tags
 	tags: {
 		[...string]
 		@dagger(output)
diff --git a/stdlib/go/go.cue b/stdlib/go/go.cue
index 0fc62547..5a836eb4 100644
--- a/stdlib/go/go.cue
+++ b/stdlib/go/go.cue
@@ -1,3 +1,4 @@
+// Go build operations
 package go
 
 import (
@@ -10,8 +11,11 @@ import (
 
 // A standalone go environment
 #Container: {
+
 	// Go version to use
 	version: *"1.16" | string @dagger(input)
+
+	// Source code
 	source:  dagger.#Artifact @dagger(input)
 
 	os.#Container & {
@@ -36,6 +40,7 @@ import (
 	}
 }
 
+// Re-usable component for the Go compiler
 #Go: {
 	// Go version to use
 	version: *"1.16" | string @dagger(input)
@@ -70,6 +75,7 @@ import (
 	]
 }
 
+// Go application builder
 #Build: {
 	// Go version to use
 	version: *#Go.version | string @dagger(input)
@@ -95,6 +101,7 @@ import (
 	// Specify the targeted binary name
 	output: string @dagger(output)
 
+	// Environment variables
 	env: {
 		[string]: string @dagger(input)
 	}
diff --git a/stdlib/io/io.cue b/stdlib/io/io.cue
index 5804cb49..a1fec92e 100644
--- a/stdlib/io/io.cue
+++ b/stdlib/io/io.cue
@@ -1,3 +1,4 @@
+// IO operations
 package io
 
 // Standard interface for directory operations in cue
@@ -13,8 +14,10 @@ package io
 	...
 }
 
+// Standard ReadWriter interface
 #ReadWriter: #Reader & #Writer
 
+// Standard Reader interface
 #Reader: {
 	read: {
 		// FIXME: support different data schemas for different formats
@@ -26,6 +29,7 @@ package io
 	...
 }
 
+// Standard Writer interface
 #Writer: {
 	write: *null | {
 		// FIXME: support writing in multiple formats
diff --git a/stdlib/js/yarn/yarn.cue b/stdlib/js/yarn/yarn.cue
index 20887bc7..f9471215 100644
--- a/stdlib/js/yarn/yarn.cue
+++ b/stdlib/js/yarn/yarn.cue
@@ -9,7 +9,7 @@ import (
 	"dagger.io/os"
 )
 
-// A Yarn package.
+// A Yarn package
 #Package: {
 	// Application source code
 	source: dagger.#Artifact @dagger(input)
@@ -28,11 +28,11 @@ import (
 	} @dagger(input)
 
 	// Write the contents of `environment` to this file,
-	// in the "envfile" format.
+	// in the "envfile" format
 	writeEnvFile: string | *"" @dagger(input)
 
 	// Read build output from this directory
-	// (path must be relative to working directory).
+	// (path must be relative to working directory)
 	buildDir: string | *"build" @dagger(input)
 
 	// Run this yarn script
@@ -41,6 +41,7 @@ import (
 	// Optional arguments for the script
 	args: [...string] | *[] @dagger(input)
 
+	// Build output directory
 	build: os.#Dir & {
 		from: ctr
 		path: "/build"
diff --git a/stdlib/kubernetes/kubernetes.cue b/stdlib/kubernetes/kubernetes.cue
index 55aa4c5f..1073ddc1 100644
--- a/stdlib/kubernetes/kubernetes.cue
+++ b/stdlib/kubernetes/kubernetes.cue
@@ -1,3 +1,4 @@
+// Kubernetes client operations
 package kubernetes
 
 import (
@@ -6,8 +7,10 @@ import (
 	"dagger.io/alpine"
 )
 
+// Kubectl client
 #Kubectl: {
 
+	// Kubectl version
 	version: *"v1.19.9" | string
 
 	#code: #"""
diff --git a/stdlib/kubernetes/kustomize/kustomization.cue b/stdlib/kubernetes/kustomize/kustomization.cue
index bcf02a10..4a8b323d 100644
--- a/stdlib/kubernetes/kustomize/kustomization.cue
+++ b/stdlib/kubernetes/kustomize/kustomization.cue
@@ -1,3 +1,4 @@
+// Kustomize config management
 package kustomize
 
 import (
diff --git a/stdlib/netlify/netlify.cue b/stdlib/netlify/netlify.cue
index b209b34e..3710a225 100644
--- a/stdlib/netlify/netlify.cue
+++ b/stdlib/netlify/netlify.cue
@@ -1,3 +1,4 @@
+// Netlify client operations
 package netlify
 
 import (
@@ -6,7 +7,7 @@ import (
 	"dagger.io/os"
 )
 
-// A Netlify account
+// Netlify account credentials
 #Account: {
 	// Use this Netlify account name
 	// (also referred to as "team" in the Netlify docs)
@@ -16,7 +17,7 @@ import (
 	token: dagger.#Secret @dagger(input)
 }
 
-// A Netlify site
+// Netlify site
 #Site: {
 	// Netlify account this site is attached to
 	account: #Account
diff --git a/stdlib/random/string.cue b/stdlib/random/string.cue
index 882e2650..a15891e1 100644
--- a/stdlib/random/string.cue
+++ b/stdlib/random/string.cue
@@ -1,16 +1,4 @@
-// Random generation utilities.
-//
-// Example:
-//
-// ```cue
-// str: random.#String & {
-//   seed: "str"
-//   length: 10
-// }
-// ```
-//
-//
-//
+// Random generation utilities
 package random
 
 import (
diff --git a/stdlib/terraform/terraform.cue b/stdlib/terraform/terraform.cue
index 9ce68852..703a7113 100644
--- a/stdlib/terraform/terraform.cue
+++ b/stdlib/terraform/terraform.cue
@@ -1,3 +1,4 @@
+// Terraform operations
 package terraform
 
 import (
@@ -7,15 +8,20 @@ import (
 	"dagger.io/dagger/op"
 )
 
+// Terraform configuration
 #Configuration: {
+
+	// Terraform version
 	version: string | *"latest" @dagger(input)
 
+	// Source configuration
 	source: dagger.#Artifact @dagger(input)
 
 	tfvars?: {
 		...
 	}
 
+	// Environment variables
 	env: {
 		[string]: string @dagger(input)
 	}