# Writing

Source: https://developer.apple.com/design/human-interface-guidelines/writing
Skill: hig-foundations
Snapshot: 2025-02-02

---
<!-- hig-doctor:attribution -->
> **Source**: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/writing.
> This file is a structured index of that content, snapshot 2025-02-02.
> Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.

# Writing

## Getting started

**Determine your app’s voice.**

**Match your tone to the context.**

**Be clear.**

**Write for everyone.**

## Best practices

**Be action oriented.**

**Build language patterns.**

**Adopt capitalization rules that align with your app’s style, then apply them consistently.**

**Give clear guidance and use consistent language throughout processes with multiple steps.**

**Use possessive pronouns sparingly.**

**Write for how people use each device.**

**Provide clear next steps on any blank screens.**

**Write clear error messages.**

**Choose the right delivery method.**

**Keep settings labels clear and simple.**

**Show hints in text fields.**

---

<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/writing