I've updated the API guidelines document to account for the review feedback and other issues. Please see http://apple.github.io/swift-internals/api-design-guidelines/ (presentation view) and https://github.com/apple/swift-internals/blob/gh-pages/api-design-guidelines/index.md (source and commit history) -- -Dave