docs: fix examples and add doc links

Amolith created 3 weeks ago

- Fix PersonBuilder example to use RelationshipCloseFriend constant
- Add godoc links for RelationshipCloseFriend, ErrUnauthorized

Assisted-by: Claude Sonnet 4 via Crush

Change summary

builders.go | 4 ++--
lunatask.go | 2 +-
2 files changed, 3 insertions(+), 3 deletions(-)

Detailed changes

builders.go

@@ -307,7 +307,7 @@ func (b *JournalEntryBuilder) Build() *CreateJournalEntryRequest {
 //	req := lunatask.NewPerson().
 //		WithFirstName("Ada").
 //		WithLastName("Lovelace").
-//		WithRelationshipStrength("close").
+//		WithRelationshipStrength(lunatask.RelationshipCloseFriend).
 //		Build()
 //	person, err := client.CreatePerson(ctx, req)
 type PersonBuilder struct {
@@ -334,7 +334,7 @@ func (b *PersonBuilder) WithLastName(name string) *PersonBuilder {
 }
 
 // WithRelationshipStrength categorizes the closeness of the relationship.
-// Use one of the Relationship* constants (e.g., RelationshipCloseFriend).
+// Use one of the Relationship* constants (e.g., [RelationshipCloseFriend]).
 func (b *PersonBuilder) WithRelationshipStrength(strength RelationshipStrength) *PersonBuilder {
 	b.req.RelationshipStrength = &strength
 

lunatask.go

@@ -144,7 +144,7 @@ type PingResponse struct {
 }
 
 // Ping verifies the access token is valid by calling the /ping endpoint.
-// Returns the ping response on success, or an error (typically ErrUnauthorized) on failure.
+// Returns the ping response on success, or an error (typically [ErrUnauthorized]) on failure.
 func (c *Client) Ping(ctx context.Context) (*PingResponse, error) {
 	resp, _, err := doJSON[PingResponse](ctx, c, http.MethodGet, "/ping", nil)