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 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 restricted, 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 so

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 wrote: > >> On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: >> >>> On Aug 16, 2015, at 3:09 PM, Alex Zavatone wrote: >>> Why isn't it in Apple's documentation for storyboards? >>> >>> Because

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 wrote: > On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: > >> On Aug 16, 2015, at 3:09 PM, Alex Zavatone wrote: >> >>> Why isn't it in Apple's documentation for storyboards? >> >> Because these are private implementation details. They are subject t

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 wrote: > > > On Aug 16, 2015, at 4:49 PM, Ken Thomases wrote: > >> On Aug 16, 2015, at 3:09 PM, Alex Zavatone wrote: >> >>> So, I look at UIStoryboard.h and the docs and see that there are 3 methods. >>> No properties. >> >>> And in using it, I fi

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 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

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 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 bunch of

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 a