• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: Documentation Workflow
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation Workflow


  • Subject: Re: Documentation Workflow
  • From: Alex Zavatone <email@hidden>
  • Date: Sat, 12 Nov 2016 17:18:04 -0600

On Nov 12, 2016, at 11:41 AM, Richard Charles wrote:

> The current documentation seems to be well formatted for display on an iPad. Does anyone have a programming work flow that uses the documentation displayed on an iPad or iOS device?
>
> I suppose if you are commuting to work riding a train or a bus and want to review the documentation on your iPad this might work well. This might also work if the documentation was sitting at your side on an iPad like a book or if you wanted to read the documentation like you would read a bound book. However I would be surprised if many programmers have a programming work flow like this. It is simply too restrictive, slow, and cumbersome when actually coding.
>
> My current workflow has a local copy of OS X 10.9 documentation displayed in Safari, often using multiple tabs, on a second display. I find this documentation setup to be very helpful, searchable, inclusive, and productive.
>
> Why is the documentation team going down this bizarre path? Do they really think we will be programming on iPads some day?
>
> --Richard Charles

The important thing is that we are not now.

Apparently, the fonts are STILL too visible.  The text in the documentation needs to be even skinnier so there is no possible chance that we can read it.  And it's really good that there are no PDF documents for us to keep as reference for anything that we searched for.

Whomever is making these decisions at Apple should be checked in to a place where they are not allowed to declare policy to anyone again, ever.



_______________________________________________

Cocoa-dev mailing list (email@hidden)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:

This email sent to email@hidden


References: 
 >Documentation Workflow (From: Richard Charles <email@hidden>)

  • Prev by Date: Re: Documentation Workflow
  • Next by Date: observeValueForKeyPath called twice when changing NSUserDefaults value
  • Previous by thread: Re: Documentation Workflow
  • Next by thread: Re: Documentation Workflow
  • Index(es):
    • Date
    • Thread