docs(godoc): add overview

list/list.go

@@ -1,3 +1,21 @@
+// Package list provides an API to create printable list structures that can be
+// included in any command line application. This package includes full support
+// for nested lists. Here's how you do it:
+//
+//	l := list.New(
+//		"A",
+//		"B",
+//		"C",
+//		list.New(
+//			"D",
+//			"E",
+//			"F",
+//		).Enumerator(list.Roman),
+//	)
+//	fmt.Println(l)
+//
+// The list package provides built-in enumerator styles to help glamourize your
+// lists. Lists are fully customizable, so let your creativity flow.
 package list
 
 import (

tree/tree.go

@@ -1,3 +1,27 @@
+// Package tree provides an API to create printable tree-like structures that
+// can be included in any command line application. It goes something like:
+//
+//	t := tree.New().
+//		Root(".").
+//		Item("Item 1").
+//		Item(
+//		tree.New().Root("Item 2").
+//			Item("Item 2.1").
+//			Item("Item 2.2").
+//			Item("Item 2.3"),
+//		).
+//		Item(
+//		tree.New().
+//			Root("Item 3").
+//			Item("Item 3.1").
+//			Item("Item 3.2"),
+//		)
+//
+//	fmt.Println(t)
+//
+// If you're looking to create a list, you can use the list package which wraps
+// the tree package with bulleted enumerations. Trees are fully customizable, so
+// don't be shy, give 'em the 'ol razzle dazzle.
 package tree
 
 import (