Live data from Hacker News

SwiftUI tutorials rewritten completely

developer.apple.com

1–10 of 115 posts

Re: SwiftUI tutorials rewritten completely

#3

> https://news.ycombinator.com/item?id=25046691 Some relevant discussion.

Yes it's unfortunate that these tutorials and WWDC transcripts are effectively the replacement of core documentation, regardless of their quality. Overviews, code listings, and conceptual docs are being added, but at a slow pace and it's hard to find which ones have been updated outside of some people posting about it on Twitter.

Re: SwiftUI tutorials rewritten completely

#4
Cool, but this documentation wasn't really the issue. Apple seems to be taking the tack of explaining a few core concepts really well while ignoring the long tail of documentation. Why are there questions like this[1] on Stack Overflow? That's a clear sign that other documentation is lacking.

[1] https://stackoverflow.com/questions/65173861/saving-a-file-t...

Re: SwiftUI tutorials rewritten completely

#5
Is it my imagination or has Apple been quietly improving and expanding the documentation for SwiftUI over the last few months? It's becoming decent, though there are still dark corners.

Apple used to be awesome at documentation. I hope this effort extends to Apple's other frameworks.

Re: SwiftUI tutorials rewritten completely

#6
post #5

Is it my imagination or has Apple been quietly improving and expanding the documentation for SwiftUI over the last few months? It's becoming decent, though there are still dark corners. Apple used to be awesome at documentation. I hope this effort extends to Apple's other frameworks.

It's been expanding ever since the WWDC 2019 release, same with other newer frameworks like Combine, and it mostly goes unnoticed. They should have some way of showing what docs have been updated, currently in the Apple Developer app I think it only highlights new articles.

Re: SwiftUI tutorials rewritten completely

#7

Cool, but this documentation wasn't really the issue. Apple seems to be taking the tack of explaining a few core concepts really well while ignoring the long tail of documentation. Why are there questions like this[1] on Stack Overflow? That's a clear sign that other documentation is lacking. [1] https://stackoverflow.com/questions/65173861/saving-a-file-t...

There's certainly a lot that could be said about the gaps in Apple's developer docs, but the answer to that question is literally, "handle your errors instead of ignoring them, and it will tell you what went wrong."

They ignored errors, so didn't know there was no "Documents" directory, and their file write therefore failed.

Re: SwiftUI tutorials rewritten completely

#8
post #5

Is it my imagination or has Apple been quietly improving and expanding the documentation for SwiftUI over the last few months? It's becoming decent, though there are still dark corners. Apple used to be awesome at documentation. I hope this effort extends to Apple's other frameworks.

Yeah, I’ve noticed that too. Which is good cause SwiftUI has tons of potential.
Post reply on HN