This is intentionally less essayistic than the rest of the manual. Each entry is short, plain, and oriented around the question "what do I click, where, and what value goes back into Ship?". If you're already comfortable with these terms, skip the appendix; the manual chapters give you the deeper reasoning.
A — The platforms Ship sits on#
- What is GitHub, and how do I sign up?
- What is a GitHub App, and why are you asking me to install one?
- What is a tracker (Linear, Jira, GitHub Issues, GitLab, Azure DevOps)?
- Code host vs tracker vs CI: what's what?
- What does "activate a repo" mean?
- What is "the Ship template bundle"?
B — Accounts and keys#
- OpenAI API key
- Anthropic API key
- Cursor API key
- Linear API key
- Notion integration token
- Jira API token
- GitHub personal access token
- GitLab personal access token
- Azure DevOps personal access token
C — Secrets, OAuth, and webhooks#
- What is a secret, and why does it never go in a prompt?
- OAuth vs API key vs personal access token (PAT)
- What is a webhook?
- What does "rotate a secret" mean and when do I do it?
- GitHub App install vs OAuth: what's the difference?
D — Words you might trip on#
- Workspace vs project vs organization
- Agent vs routine vs specialist
- Why is the Inbox called Inbox?
- Knowledge vs documentation
- What does the audit log actually contain?
- Quiet workspace: when good, when suspicious?
E — When you're stuck#
How the wizard cross-links into this page#
Settings forms and onboarding wizard steps deep-link to the entry they need next to a [?] icon. The entry's URL is stable; bookmark it if you need to come back. The cheap habit is to follow the wizard's link, do what the entry says, come back, paste the value into Ship. Don't paste secret values anywhere else along the way.