Siamak (Ash) Ashrafi on how he has seen iOS and Android development switch places when it comes to guidance on app architecture. Apple used to firmly encourage an MVC approach, but that has gone these days. Whereas, Android:
In the early days, Android developers faced a lack of guidance on app architecture. With no best practices provided, every developer implemented their own approach, leading to fragmented use of languages, tools, and design principles. This inconsistency resulted in many poorly designed apps on the Play Store, and unfortunately, the blame often fell on Android itself rather than the individual apps — users simply said, “Android sucks.” Fortunately, Google now offers clear guidelines and best practices, helping developers create robust, consistent, and high-quality Android apps.
He offered a link to Google’s Guide to app architecture and I enjoyed reading it. I thought I agreed with Apple’s recent stance of being completely architecture agnostic, especially when it comes to SwiftUI code. It’s hard to give generic advice about app architecture, but this guide does a great job. They have a whole learning pathway on the subject, too.
The topic of documentation came up several times, too. While there wasn’t anything particularly new said, the same old points remain. James Clarke :
Improving API documentation for Apple APIs giving usage examples.
It’s that last part about “examples” that comes up over and over again, and I’m confident it’s why blogs that take an Apple API and add code examples of using it do so well.
Also, from Daniel Steinberg:
Bring back the old Programming Guides. There are big topics that need those overviews and not API by API docs
I miss them too, Daniel! I understand what Apple is trying to do with adding articles in and around the API documentation, and those articles are great! However, as much as Apple might intend them to replace the old programming guides, they don’t do it well enough. I understand that the “book style” format must have been more work to maintain than shorter articles are, but I miss the way they guided you through a topic.
Finally, bless Marius Felkner for echoing my recent take by hoping for:
Opinionated stuff (Swift Format Rules etc)
It was a fascinating glance at what you all think, and I hope you found the results interesting! Thanks for reading.
Dave Verwer
Staff Software Engineer - iOS @ NewStore – Join NewStore and be part of a forward-thinking team dedicated to crafting exceptional mobile experiences. We embrace TDD, pairing, and best engineering principles, fostering an environment where you can lead, inspire, and help shape the future of our iOS engineering culture. – Remote (within European timezones) with some on-site work (Germany, Netherlands, or United Kingdom)
Senior iOS Developer @ komoot – You’ll team up with six world-class iOS engineers, take over full responsibility for our iOS app, and develop diverse features for navigation, routing, social interaction, and content visualization that will make your work challenging and fun. – Remote (within European timezones)
As I mentioned above, this isn’t a new format for the newsletter and links will be back next week for sure.
I do want to experiment a little though, so if this issue made you feel something positive or negative, please do let me know. Just hit “Reply”.