Add language reference to unified documentation and API reference

Originator:ole.begemann
Number:rdar://27471627 Date Originated:21-Jul-2016 05:27 PM
Status:Open Resolved:
Product:Documentation Product Version:Xcode 8.0 beta 3
Classification:Enhancement Reproducible:Not Applicable
 
Summary:
The new unified API documentation in Xcode is great. However, I strongly feel it should not only contain API docs, but also language reference for Apple's languages (Swift and Objective-C, possibly also C and C++).

Steps to Reproduce:
1. Open the Documentation and API Reference in Xcode 8 (Cmd + Shift + 0).
2. Search for a Swift language keyword, such as "associatedtype"

Expected Results:
A reference doc explaining the keyword shows up in the search results, ideally as the first item in the live search results list.

Actual Results:
If you look at all search results and switch to "Tools Guides", references to "The Swift Programming Language" show up that eventually explain the keyword if you browse the book long enough. This is better than nothing, but it's very often not easy to find what you're looking for. A concise reference documentation for all language keywords etc. would go a long way.

Regression:
n/a

Notes:
n/a

Comments


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!