Objective-C interop doc updates

[liamappelbe]

Update The Objective-C interop documentation to use the new FFIgen config Dart API, instead of YAML configs. I haven't updated the Swift example, because that will soon be replaced by swiftgen.

Fixes dart-lang/native#2710

[dart-github-bot]

Visit the preview URL for this PR (updated for commit af0282f):

https://dart-dev--pr6942-objc-update-w8nmy44j.web.app

[parlough]

I believe the failure was from a version of Jaspr that had a regression. I updated the branch with main which should pull in the release with a fix.

I'm guessing swift isn't a supported language for the syntax highlighting? It works when I change the language to dart, but obviously that's not a viable solution. Any suggestions? Is there a list of supported languages somewhere?

You're right, Swift isn't supported yet, but if swift is specified, it should fall back to no syntax highlighting. The list of supported languages can be found in site/lib/src/extensions/code_block_processor.dart.

I'm planning to work on basic support for Swift soon, is the no highlighting fallback sufficient until I can finish that?

[liamappelbe]

I'm planning to work on basic support for Swift soon, is the no highlighting fallback sufficient until I can finish that?

Yep, no hilighting is fine for now.

[liamappelbe]

@parlough This is ready for review. PTAL

[parlough]

Sorry about the delay in reviewing this. I'll make sure to take a look before Monday!

\cc @antfitch For reviewing the writing and structure.

[parlough]

Overall these updates look good to me after a few updates, thanks for coming back to them @liamappelbe!

Do wait for @antfitch's approval as well before landing :)

[antfitch]

Overall these updates look good to me after a few updates, thanks for coming back to them @liamappelbe!

Do wait for @antfitch's approval as well before landing :)

No need for me this time. Triaging this back to you @parlough to land. Love the changes, folks!

[antfitch]

Hey all, this is a bit larger than I first thought. @parlough, when you're finished with your review, let me know and I'll do a final edit pass.

[antfitch]

After the engineering pass with @parlough, I'll circle by with a writing pass.

[antfitch]

Added my edits directly to objective-c-interop.md. Nothing significant and everything looked great.

[parlough]

It seems Amanda's commit accidentally undid some of the changes you applied and made. Tomorrow I can reapply what's necessary and land this.

Thank you both!