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