chore(docs): links + minor grammar fixes

color.go

@@ -66,7 +66,7 @@
 		if h, err := colorful.Hex(c); err == nil {
 			return h
 		} else if i, err := strconv.Atoi(c); err == nil {
 			if i < 16 { //nolint:gomnd
 				return ansi.BasicColor(i) //nolint:gosec
 			} else if i < 256 { //nolint:gomnd
 				return ansi.ExtendedColor(i) //nolint:gosec
@@ -134,13 +134,14 @@
 // In practice, there are slightly different workflows between Bubble Tea and
 // Lip Gloss standalone.
 //
-// In Bubble Tea listen for tea.BackgroundColorMsg, which automatically
-// flows through Update on start, and whenever the background color changes:
+// In Bubble Tea, listen for tea.BackgroundColorMsg, which automatically
+// flows through Update on start. This message will be received whenever the
+// background color changes:
 //
 //	case tea.BackgroundColorMsg:
 //	    m.hasDarkBackground = msg.IsDark()
 //
-// Later, when you're rendering:
+// Later, when you're rendering use:
 //
 //	lightDark := lipgloss.LightDark(m.hasDarkBackground)
 //	myHotColor := lightDark("#ff0000", "#0000ff")

query.go

@@ -38,12 +38,12 @@ func BackgroundColor(in *os.File, out *os.File) (color.Color, error) {
 // Typically, you'll want to query against stdin and either stdout or stderr
 // depending on what you're writing to.
 //
-//	hasDarkBG, _ := HasDarkBackground(os.Stdin, os.Stdout)
-//	adaptive := Adapt(hasDarkBG)
-//	myHotColor := Color("#ff0000", "#0000ff")
+//	hasDarkBG, _ := lipgloss.HasDarkBackground(os.Stdin, os.Stdout)
+//	lightDark := lipgloss.LightDark(hasDarkBG)
+//	myHotColor := lightDark("#ff0000", "#0000ff")
 //
-// This is intedded for use in standalone Lip Gloss only. In Bubble Tea, listen
-// for tea.BackgroundColorMsg in your update function.
+// This is intended for use in standalone Lip Gloss only. In Bubble Tea, listen
+// for tea.BackgroundColorMsg in your Update function.
 //
 //	case tea.BackgroundColorMsg:
 //	    hasDarkBackground = msg.IsDark()

set.go

@@ -175,7 +175,7 @@
 
 // Underline sets an underline rule. By default, underlines will not be drawn on
 // whitespace like margins and padding. To change this behavior set
-// UnderlineSpaces.
+// [Style.UnderlineSpaces].
 func (s Style) Underline(v bool) Style {
 	s.set(underlineKey, v)
 	return s
@@ -705,19 +705,19 @@
 		left = i[0]
 		right = i[0]
 		ok = true
 	case 2: //nolint:gomnd
 		top = i[0]
 		bottom = i[0]
 		left = i[1]
 		right = i[1]
 		ok = true
 	case 3: //nolint:gomnd
 		top = i[0]
 		left = i[1]
 		right = i[1]
 		bottom = i[2]
 		ok = true
 	case 4: //nolint:gomnd
 		top = i[0]
 		right = i[1]
 		bottom = i[2]
@@ -738,19 +738,19 @@
 		left = i[0]
 		right = i[0]
 		ok = true
 	case 2: //nolint:gomnd
 		top = i[0]
 		bottom = i[0]
 		left = i[1]
 		right = i[1]
 		ok = true
 	case 3: //nolint:gomnd
 		top = i[0]
 		left = i[1]
 		right = i[1]
 		bottom = i[2]
 		ok = true
 	case 4: //nolint:gomnd
 		top = i[0]
 		right = i[1]
 		bottom = i[2]
@@ -771,19 +771,19 @@
 		left = i[0]
 		right = i[0]
 		ok = true
 	case 2: //nolint:gomnd
 		top = i[0]
 		bottom = i[0]
 		left = i[1]
 		right = i[1]
 		ok = true
 	case 3: //nolint:gomnd
 		top = i[0]
 		left = i[1]
 		right = i[1]
 		bottom = i[2]
 		ok = true
 	case 4: //nolint:gomnd
 		top = i[0]
 		right = i[1]
 		bottom = i[2]

size.go

@@ -10,7 +10,7 @@ import (
 // ignored and characters wider than one cell (such as Chinese characters and
 // emojis) are appropriately measured.
 //
-// You should use this instead of len(string) len([]rune(string) as neither
+// You should use this instead of len(string) or len([]rune(string) as neither
 // will give you accurate results.
 func Width(str string) (width int) {
 	for _, l := range strings.Split(str, "\n") {
@@ -24,9 +24,8 @@ func Width(str string) (width int) {
 }
 
 // Height returns height of a string in cells. This is done simply by
-// counting \n characters. If your strings use \r\n for newlines you should
-// convert them to \n first, or simply write a separate function for measuring
-// height.
+// counting \n characters. If your output has \r\n, that sequence will be
+// replaced with a \n in [Style.Render].
 func Height(str string) int {
 	return strings.Count(str, "\n") + 1
 }

style.go

@@ -96,7 +96,7 @@ func (p props) has(k propKey) bool {
 }
 
 // NewStyle returns a new, empty Style. While it's syntactic sugar for the
-// Style{} primitive, it's recommended to use this function for creating styles
+// [Style]{} primitive, it's recommended to use this function for creating styles
 // in case the underlying implementation changes.
 func NewStyle() Style {
 	return Style{}
@@ -155,10 +155,10 @@ func joinString(strs ...string) string {
 }
 
 // SetString sets the underlying string value for this style. To render once
-// the underlying string is set, use the Style.String. This method is
+// the underlying string is set, use the [Style.String]. This method is
 // a convenience for cases when having a stringer implementation is handy, such
 // as when using fmt.Sprintf. You can also simply define a style and render out
-// strings directly with Style.Render.
+// strings directly with [Style.Render].
 func (s Style) SetString(strs ...string) Style {
 	s.value = joinString(strs...)
 	return s