Xcode 8 자동 생성 빠른 도움말 문서

에 발표 된 새로운 기능으로는 엑스 코드 (8) , 우리는 볼 수 있습니다

"빠른 도움말 문서 자동 생성":

NSHipster에서이 기사에서 배울 수있는 것처럼 이것이 수동 코드 문서의 끝 입니까?

누군가이 새로운 기능의 장단점을 설명 할 수 있습니까? Jazzy와 같은 도구를 대체합니까 ?

새로운 기능에 대한 자세한 정보를 찾을 수 없습니다.

이것은 다음과 같은 방법을 선택할 수있는 Xcode 8 (이상) 기능을 나타냅니다.

func foo(bar: Int) -> String { ... }

... 그런 다음 ⌘+ option+ 를 누르면 /(또는 Xcode의 "편집기"메뉴에서 "구조"» "문서 추가"를 선택) 다음 주석 템플릿이 생성됩니다.

/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>

빠른 도움말에 대한 문서 작성을 용이하게합니다.

이 동작은 시간이 지남에 따라 약간 변경되었지만 Xcode는이를 수행하려고 할 때 커서가 있어야하는 위치를 구체적으로 지정할 수 있습니다. 예를 들어, 위의 예에서 커서가 함수 이름의 어딘가에 foo있어야 작동합니다. 또는 함수 이름을 두 번 클릭 한 다음 ⌘+ option+ 를 누릅니다./

이것은 키보드가 Shift 키를 눌러야하는 경우 '/'가있는 모든 핫키가 현재 XCode 8 빌드에서 작동하지 않는다는 사실과 관련이 있습니다.

즉, 독일어 키보드에서 '/'는 shift + 7이고 alt + cmd + shift-7을 눌러도 작동하지 않습니다. 즉 cmd + shift + opt + d를 할당하면 제대로 작동합니다.

안타깝게도 현재 작동하지 않는 바로 가기 '///'는이 바로 가기를 정확히 사용하는 이전 XCode 플러그인 VVDocumenter 때문일 수 있습니다.

훌륭한 기능, Apple 측의 형편없는 QA.