How to read apple documentation?

I am trying to learn which function and properties to use and some time it is hard to imply because lot of them do not have examples so how can I be able to read apple documentation and can choose right function and property whenever needed or design any app reading apple documentation

XCode documentation is just to get reference of functions ; not many examples on how to achieve something.


There is another documentation, with many examples; go have a look at:

h ttps://developer.apple.com/library/content/navigation/


Is it what you are looking for ?


Another way is to search the web with query as :

Swift how to doWhatIWant ; with forums like stackOverflow, you will get useful advices.

As I made in my own post on the matter, Apple make it a tortuous case of reverse engineering when examples are absent.


The lack of examples is astoundingly woeful. It is very very common for develoopment tools to be terse, minimilsitic as programmers hate to document.


I coded www.delphibasics.co.uk as I learnt Delpin in 2002. In all that time, the developers of Delphi were not able to replicate the examples I offered.


How do developers expect us to work out how to string together complex event driven software without examples? How do I add a checkbox to an NSOutlineView and get the code to process it? You try working that out from the reference info.


Sure, there are a lot of examples out there, but Apple keeps changing the syntax - another really really bad idea - so most code is outdated.


Appled could easily maintain a set of examples across all releases of Swoft/Xcode for a munuscule fraction of the wealth they sit on.


They deliver awesome products to consumers and forget that programmers are consumers of development tools. Why these crazy omission?

You're right. The times of inside Macintosh are definitely (?) gone.

Some devs look at the docs as something they're not - they approach them as **tutorials**, when in fact they are **reference** material.

Remember - you have the docs, guides and sample apps.


Study sample code for implementation examples of various features. Each sample code project is a build-able and executable source example of how to accomplish a task for a specific technology. They show the correct sequence of calls and parameter data types to provide a generalized method for API use that developers can modify for their specific needs. Sample code is typically intended to show programming techniques and illustrate use of technology rather than suggest user interface designs (that's what the HIG are for). Scan the readme with each sample and don't forget to check the comments in each file.


If you want an understanding of how everything fits together, as noted, you should read one of the associated Guides.


>Appled could easily maintain a set of examples across all releases of Swoft/Xcode for a munuscule fraction of the wealth they sit on.


Perhaps after Swift has an ABI. Too much of a moving target stil, I think to even consider a large commitment.


If there are samples you would like to see to illustrate particular technologies or techniques that are not covered by existing downloads, feel free to file a bug report...link is below right, every page here.


Just remember that macOS seems low on the list when it comes to documentation, samples etc., so best to keep expectations appropriately calibrated.


Good luck.

How to read apple documentation?
 
 
Q