Post

Replies

Boosts

Views

Activity

Comment on Potential Issue Identified in Apple Documentation
A lexicographical comparison of version numbers can lead to incorrect results in real-world scenarios, potentially causing unintended behavior in production. Anyone referencing this example without catching the mistake would be implementing a broken check. If API documentation includes examples, they should be correct and reliable, not just placeholders. Developers trust these examples, and Apple should ensure they demonstrate best practices—or at the very least, functional logic
1w
Comment on Potential Issue Identified in Apple Documentation
I understand that Apple’s documentation is primarily meant to demonstrate API usage, but that doesn’t mean it should contain flawed logic that could mislead developers. The example isn’t just showcasing syntax—it’s demonstrating how to determine whether a user’s app version predates a business model change. If the provided logic doesn’t actually work correctly, then the documentation is, by definition, incorrect.
1w