Installing CocoaPods is a nightmare with this instruction

[Stucklog]

Page URL

https://docs.flutter.dev/get-started/install/macos/mobile-ios/

Page source

https://github.com/flutter/website/tree/main/src/content/get-started/install/macos/mobile-ios.md

Describe the problem

Attempting to install CocoaPods as instructed here results in many problems to a novice in computer science such as myself. I think the problem is that the ruby installation shipping with Macs is too old for CocoaPods. It took me an hour attempting an untraceable patchwork of fixes to finally get it running well enough for 'flutter doctor' to put a green checkmark next to Xcode.

Expected fix

Would love this updated to help learners through these seemingly inevitable issues.

Additional context

Happened both on my old Intel Mac and my M2 Pro Mac mini, both running sequoia.

I would like to fix this problem.

• [ ] I will try and fix this problem on docs.flutter.dev.