Appendix

Knowledge: how is it different from documentation?

Documentation lives wherever your team writes it — Notion, Confluence, a docs/ folder in the repo, a wiki. Knowledge in Ship is the agent-facing version of that content — short articles, organized in buckets, that agents read when they're working on a routine. The same content can be in both places; "knowledge" is just the path that's optimized for agents to consume, with clear titles, no sidebar navigation, no version history dropdown.

If you have great docs already, Ship can mirror them; you don't have to write everything twice. You can also write knowledge articles that are only for agents — bits of context that are too specific to document in Notion but crucial for a routine to work correctly. For example, a knowledge article might capture "when we say 'RTL', we mean 'right-to-left' in the context of locale support, not 'regression testing log'", paired with a routine that catches ambiguous terminology in ticket descriptions.

Back to Appendix index