iOS Dev Weekly - iOS Dev Weekly - Issue 630

Did you know that DocC could create interactive tutorials? Let's showcase some. 🎭
 

iOS Dev Weekly

 
View on the Web    Archives

ISSUE 630  October 6th 2023

 
Comment

  Comment  

 

When Apple unveiled DocC two years ago, I don’t think anyone was too surprised to see it produce documentation from source code comment annotations with Markdown formatting.

But that wasn’t all DocC did, and it was a pleasant surprise when we learned it could use Markdown for both navigation structure and long-form documentation to accompany your generated API reference.

No one would have raised an eyebrow if that’s where the tool’s capabilities had stopped. But there was one big surprise left with it being able to produce fully interactive tutorials, like the Apple-authored ones they created to teach SwiftUI. It makes sense for Apple’s internal teams to all use the same tool rather than having a “documentation tool” and a “tutorial tool”, but I still didn’t expect it.

The slight downside is that those tutorials, while beautiful and easy to read, with screenshots that persist while the reader scrolls past multiple tutorial steps, take a long time to create. Would anyone outside Apple be willing to put the work in to make them?

So I’ve been idly keeping track every time I spot one in the wild, and while I’d not call them common, there are still plenty around, and I’d love to showcase a few for you today.

They’re even used to create training/workshop material, which I didn’t expect.

It’s fantastic to see people put time and effort into creating such high-quality tutorials. However, if you just looked through those and felt intimidated, remember that any documentation is better than nothing. Start with API reference documentation, go deeper with Markdown articles, and only consider adding the “icing on the cake” with a tutorial after that.

It’s great to see such a strong start from DocC. This comment is already too long, but I might write about how many packages we see adopting it in the Swift Package Index at some point soon. It’s more than we expected!

Dave Verwer  Permalink

 
 

  Sponsored Link  

 

Fast, AI-powered test automation with Testim Mobile

We’re built to help Agile teams manage and scale test automation. Author tests quickly, improve stability, and run using real and virtual devices. Learn more about Testim Mobile.

testim.io  Permalink

 
 
 

  Tools  

 

SwiftFormat Automation

I’ve written about my ideal setup for formatting and linting in Xcode. However, what I wished for doesn’t exist yet, so in the mean time, you should probably read Pranav Kasetti’s approach to getting part of the way there with what we have available today.

codewithkasetti.com  Permalink

 
 

  Code  

 

Swift Splash visionOS Sample Code

This new visionOS sample code from Apple looks excellent and is a great reminder that great documentation doesn’t have to be a slick, step-by-step tutorial. These larger sample code projects are great to see several aspects of the SDK work together. 👍

apple.com  Permalink

 

Changes to URL string parsing

I wasn’t aware of this change to URL, and while Toomas Vahter is correct that there’s an “important” warning on the official API docs, if Apple changes anything about URL parsing, that needs publicising.

Switching to the newer URL specification is a big deal, and in addition, the last sentence says that the new default (…) tries to encode invalid characters. This is a big deal.

Read this article and the API docs before checking nothing has broken in your apps.

augmentedcode.io  Permalink

 

Split your data easily and efficiently

There are so many useful little utilities and helpers in swift-algorithms (and in swift-collections, while we’re at it!), Here’s Danijela Vrzan to tell us all about one in particular. 👍

danijelavrzan.com  Permalink

 

An Interactive Intro to CRDTs

You might have heard mention of CRDTs over the last few years. I don’t remember if I first encountered them in one of Drew McCormack’s posts or by talking with Chris Eidhof, but they are a tempting solution to a long-standing and challenging problem. If they’re new to you, you could do far worse than reading and playing with the interactive demos in Jake Lazaroff’s latest post. Incredible work!

After that, it might be time to check out some of these packages.

jakelazaroff.com  Permalink

 
 

  Design  

 

SF Symbols 5

Seeing how far SF Symbols has come over the last few years is always fantastic, with hundreds of new symbols in every release (making more than 5,000 total!), colour, animation, and better localisation. It’s invaluable, and this year’s release is predictably even better, with better animations and more than 700 new glyphs.

The new app will get delivered through Software Update, or at least it did for me! So, manually installing this new version is unnecessary if you already have v4.

apple.com  Permalink

 
 

  Videos  

 

Swift TO

Why not start your weekend with a few recent Swift TO conference talks? Covering everything from how SwiftUI will destroy the publishing industry to how to build accessibility at the core of your development process, you’re sure to find something you’ll be interested in!

swiftconf.to  Permalink

 
 

  Books  

 

SwiftData by Example

Available as a PDF download or an online version that you can read for free, I’m confident Paul Hudson’s is the most comprehensive look at Apple’s new persistence framework there is. Incredibly, he published this book (effectively) simultaneously with the framework itself. That’s remarkable work. 🚀

gumroad.com  Permalink

 
 

  Jobs  

 

Senior iOS Developer @ Linearity GmbH – We’re an award-winning design software suite that simplifies the asset creation process. Linearity Curve creates precision vector assets & Linearity Move is an animation software that crafts breathtaking animations in seconds. We’re crafting together a new iOS team, reach out if you're Interested! – Remote (within European timezones)

Senior iOS Engineer @ Luma AI – We are a small AI research and product company working on new kinds of creative tools for 3D. Our mission is to democratize the 3D experience for all. iOS at Luma is at the center of the product universe. We are growing the iOS team from 1-4, please reach out if you're interested! – On-site (United States in CA) with some remote work (within US timezones)

 Permalink

 

Would you like to see your company’s open positions listed above? Post your job over on iOS Dev Jobs, and check out with a “Featured Listing”, and they’ll be here next week!

 Permalink

 
 

  And finally...  

 

“Come over and see your old pals when you’re done to talking to that guy.”

Great stories.

 Permalink

 
You received this email because you subscribed via the iOS Dev Weekly site.
We'll be sorry to see you go but you can unsubscribe instantly.
 
Shiny Development Ltd. Daresbury Innovation Centre Keckwick Lane Daresbury Cheshire WA4 4FS United Kingdom
 
 

 
 

RSS

 
©2023 iOS Dev Weekly | Privacy Policy | Mastodon | Twitter | Suggest a Link
 
Published with Curated

Older messages

iOS Dev Weekly - Issue 629

Friday, September 29, 2023

Should we be wishing for more custom UI in Settings.app? ⚙️ View on the Web Archives ISSUE 629 September 29th 2023 Comment I was chatting with a friend yesterday, and he asked what I thought of the new

iOS Dev Weekly - Issue 628

Friday, September 22, 2023

What does the future of testing in Swift look like? Find out, and give feedback! 📚 View on the Web Archives ISSUE 628 September 22nd 2023 Comment Happy new device day! Thanks also for all of the kind

iOS Dev Weekly - Issue 627

Sunday, September 17, 2023

No commentary today, but plenty of links! 🔗🔗🔗 View on the Web Archives ISSUE 627 September 15th 2023 Comment I hope you'll forgive me for skipping my commentary in today's issue. I've been

iOS Dev Weekly - Issue 626

Friday, September 8, 2023

Are all human eyes approximately the same distance apart? 🤷‍♂️ View on the Web Archives ISSUE 626 September 8th 2023 Comment I said last week that I don't expect any big Vision Pro news in

iOS Dev Weekly - Issue 625

Friday, September 1, 2023

Running all the tests is for pre-commit hooks and CI only! View on the Web Archives ISSUE 625 September 1st 2023 Comment I noticed Mike Gerasimenko's new XcodeSelectiveTesting library this week,

You Might Also Like

Import AI 399: 1,000 samples to make a reasoning model; DeepSeek proliferation; Apple's self-driving car simulator

Friday, February 14, 2025

What came before the golem? ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏

Defining Your Paranoia Level: Navigating Change Without the Overkill

Friday, February 14, 2025

We've all been there: trying to learn something new, only to find our old habits holding us back. We discussed today how our gut feelings about solving problems can sometimes be our own worst enemy

5 ways AI can help with taxes 🪄

Friday, February 14, 2025

Remotely control an iPhone; 💸 50+ early Presidents' Day deals -- ZDNET ZDNET Tech Today - US February 10, 2025 5 ways AI can help you with your taxes (and what not to use it for) 5 ways AI can help

Recurring Automations + Secret Updates

Friday, February 14, 2025

Smarter automations, better templates, and hidden updates to explore 👀 ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏

The First Provable AI-Proof Game: Introducing Butterfly Wings 4

Friday, February 14, 2025

Top Tech Content sent at Noon! Boost Your Article on HackerNoon for $159.99! Read this email in your browser How are you, @newsletterest1? undefined The Market Today #01 Instagram (Meta) 714.52 -0.32%

GCP Newsletter #437

Friday, February 14, 2025

Welcome to issue #437 February 10th, 2025 News BigQuery Cloud Marketplace Official Blog Partners BigQuery datasets now available on Google Cloud Marketplace - Google Cloud Marketplace now offers

Charted | The 1%'s Share of U.S. Wealth Over Time (1989-2024) 💰

Friday, February 14, 2025

Discover how the share of US wealth held by the top 1% has evolved from 1989 to 2024 in this infographic. View Online | Subscribe | Download Our App Download our app to see thousands of new charts from

The Great Social Media Diaspora & Tapestry is here

Friday, February 14, 2025

Apple introduces new app called 'Apple Invites', The Iconfactory launches Tapestry, beyond the traditional portfolio, and more in this week's issue of Creativerly. Creativerly The Great

Daily Coding Problem: Problem #1689 [Medium]

Friday, February 14, 2025

Daily Coding Problem Good morning! Here's your coding interview problem for today. This problem was asked by Google. Given a linked list, sort it in O(n log n) time and constant space. For example,

📧 Stop Conflating CQRS and MediatR

Friday, February 14, 2025

​ Stop Conflating CQRS and MediatR Read on: m​y website / Read time: 4 minutes The .NET Weekly is brought to you by: Step right up to the Generative AI Use Cases Repository! See how MongoDB powers your