Re: Documentation Viewer is Buggy (Game Kit)
Re: Documentation Viewer is Buggy (Game Kit)
- Subject: Re: Documentation Viewer is Buggy (Game Kit)
- From: Doug Hill <email@hidden>
- Date: Wed, 28 Jun 2017 09:20:31 -0700
> On Jun 28, 2017, at 9:12 AM, Jens Alfke <email@hidden> wrote:
>
>
>> On Jun 28, 2017, at 2:12 AM, Dave <email@hidden
>> <mailto:email@hidden>> wrote:
>>
>>> Apple’s new style documentation is amazing.
>>
>> The only thing I find amazing about it that a company with so much money and
>> resources can produce something so bad and then think it good!
>>
>>> You can choose Swift or Objective-C, it is fully functional on an iPhone or
>>> iPad
>>
>> So are PDFs!
>
> As a contrarian I have to point out that PDFs are awful for accessibility:
> • The font size can’t be increased without magnifying the whole page, so it
> may no longer fit in the window.
> • Text-to-speech often doesn’t work because it’s impossible to reliably
> figure out how the text flows from one line to the next.
> Which may not be an issue for most of us, but it means Apple can’t use them
> as its primary documentation.
>
> —Jens
Just as an FYI, PDF has great accessibility markup which is supported by many
tools. if you use accessibility markup on the PDF, text flow is well specified
and text-to-speech works great.
Agreed that reflowing text is not great for PDF. But I’d argue that it might be
better to have a document that is readable anywhere with any standard reader.
PDF turns out to be great for this kind of thing, particularly where formatting
is so important.
Also, presumably, Apple could use a toolset that could output many different
document formats, perhaps appeasing many interested parties.
Doug
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden