Re: Help understanding Apple's approach in documentation a little better.

2015-08-17 Thread Steve Christensen
On Aug 16, 2015, at 2:58 PM, Alex Zavatone z...@mac.com wrote: Would be REALLY nice if there was something visual that simply communicated to you that they are not for public consumption. If I see it in the left pane of the debugger, and no visual indicators are stating that it's

Re: Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Marco S Hyman
If the debugger's variable pane exposes it, it's misleading if it doesn't somehow indicate that it's not for the developer to access. It is there for the developer to access -- when debugging. Might even be useful. I sometimes find the information useful when trying to understand how

Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Alex Zavatone
I'm currently writing a storyboard inspector for helping to create more modular app pieces in iOS (8) The idea is if you have enough functionality that is self contained enough, it should (I hope) be organizationally more efficient to create a storyboard that handles the desired functionality

Re: Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Ken Thomases
On Aug 16, 2015, at 3:09 PM, Alex Zavatone z...@mac.com wrote: So, I look at UIStoryboard.h and the docs and see that there are 3 methods. No properties. And in using it, I find out that in addition to the 3 methods within UIStoryboard.h, inside a an instance of UIStoryboard, there are a

Re: Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Alex Zavatone
On Aug 16, 2015, at 5:35 PM, Ken Thomases wrote: On Aug 16, 2015, at 4:18 PM, Alex Zavatone z...@mac.com wrote: On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: On Aug 16, 2015, at 3:09 PM, Alex Zavatone z...@mac.com wrote: Why isn't it in Apple's documentation for storyboards?

Re: Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Mike Abdullah
On 16 Aug 2015, at 22:18, Alex Zavatone z...@mac.com wrote: On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: On Aug 16, 2015, at 3:09 PM, Alex Zavatone z...@mac.com wrote: So, I look at UIStoryboard.h and the docs and see that there are 3 methods. No properties. And in using it,

Re: Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Ken Thomases
On Aug 16, 2015, at 4:18 PM, Alex Zavatone z...@mac.com wrote: On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: On Aug 16, 2015, at 3:09 PM, Alex Zavatone z...@mac.com wrote: Why isn't it in Apple's documentation for storyboards? Because these are private implementation details. They

Re: Help understanding Apple's approach in documentation a little better.

2015-08-16 Thread Alex Zavatone
On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: On Aug 16, 2015, at 3:09 PM, Alex Zavatone z...@mac.com wrote: So, I look at UIStoryboard.h and the docs and see that there are 3 methods. No properties. And in using it, I find out that in addition to the 3 methods within