Xcode 8 otomatik oluşturulan hızlı yardım belgeleri

Xcode 8'de duyurulan yeni özellikler arasında görebiliyoruz

"Hızlı Yardım belgelerini otomatik oluştur":

NSHipster'dan bu makalede öğrenebileceğimiz gibi manuel kod belgelerinin sonu bu mu?

Birisi bu yeni özelliğin artılarını ve eksilerini özetleyebilir mi? Jazzy gibi aletlerin yerini alıyor mu ?

Yeni özellik hakkında daha fazla bilgi bulamadım.

Bu, aşağıdaki gibi bir yöntem seçebileceğiniz Xcode 8 (ve sonrası) özelliğini ifade eder:

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

... ve sonra ⌘+ option+ tuşlarına basın /(veya Xcode'un "Düzenleyici" menüsünden "Yapı" »" Belge ekle "yi seçin) ve sizin için aşağıdaki yorum şablonunu oluşturacaktır:

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

Sadece Hızlı Yardım için belgelerin yazılmasını kolaylaştırır.

Unutmayın, bu davranış zaman içinde biraz değişmiş olsa da, Xcode bunu yapmaya çalıştığınızda imlecin nerede olması gerektiği konusunda özel olabilir. Örneğin, yukarıdaki örneğimde, bunun çalışması için imlecin işlev adında bir yerde olması gerekir foo. Veya işlev adına çift tıklayın ve ardından ⌘+ option+/

Bu, büyük olasılıkla, klavyenizin elde etmek için shift tuşuna basmanız gerekiyorsa, '/' ile TÜM kısayol tuşlarının mevcut XCode 8 yapısında çalışmaması gerçeğiyle ilgilidir.

Yani, almanca klavyede '/' shift + 7'dir, alt + cmd + shift-7 tuşlarına basmak bir şey yapmaz. İe cmd + shift + opt + d atarsanız, gayet iyi çalışır.

Maalesef şu anda da çalışmayan '///' kısayolu, muhtemelen tam olarak bu kısayolu kullanan eski XCode eklentisi VVDocumenter'dan kaynaklanıyor.

Harika bir özellik, Apple tarafında kötü QA.