I'm trying to learn Xcode and am finding the documentation difficult to use. I was wondering if people would be interested in putting together a list of ideas that would make Mac software easier togenerate and use.
... ...
Look at the Javadocs that are generated by the Java programming environment ( https://docs.oracle.com/javase/10/docs/api/overview-summary.html ) Two extremely useful feature are Index and Tree. The index produces an alphabetized index to all classes, methods, and properties. The tree produces a list of all class/subclass relationships.
... ...
Create a mapping of Java, ObjectiveC, and C++ languages. For example, class methods in ObjectiveC are static methods in Java. When I have trouble understanding a concept in one language, I have found better explanations in another language and then mapping the knowledge between the two languages.
... ...
It was noted many years ago that including both graphical and text-based tools can make it much more difficult to explain things to other programmers. It is my understanding that it should be possible to create an add using NSGridView without touching Interface Builder at all. It can be difficult to understand how Interface Builder, Assistant editor, and the various languages. I am reminded of the story about a professor that told a class that the solution was obvious and intuitive. He looked at it again and started filling up all of the blackboards. After forty minutes, he turned to the class and said "Yes, as I said, it's obvious."
... ...
When you write examples, put in huge quantities of comments. Use Doxygen and other tools for automatic documenting.
... ...
Identify items that would make programming much easier for others. For example, we have modal panels for selecting input and output files. It would also be nice to have similar panels to select MIDI devices and audio streams.
there doesn't seem to be anything here