Re: documentation window scrolls its contents spontaneously
Re: documentation window scrolls its contents spontaneously
- Subject: Re: documentation window scrolls its contents spontaneously
- From: Ronald Hayden <email@hidden>
- Date: Wed, 09 Sep 2009 13:25:45 -0700
Following up on a couple of points with updated info:
What really angers me is that
you've changed the URLs for your entire online documentation, and now
thousands of useful links from blogs are broken.
We found that URLs with different cases (most often "DOCUMENTATION" in
the path) were not getting properly redirected, and we've fixed that.
The intent is for all old URLs to redirect properly, so please let me
know of any that still don't work.
Please, sort out your URL schema and never change it again.
The change we made with the release of Snow Leopard is actually our
sorting out of the high-level URL scheme, and will make it much less
likely for URLs to break in the future.
Because we cannot guarantee that very granular URLs will always work
(such as to a chapter in a book where the chapter might get removed at
some point in the future), for a few years now we've had a script on
the site that will take you to the closest book destination if the URL
doesn't exist. In most cases, this means if the URL inside a book
doesn't exist anymore, you'll get to the landing page for the book it
was part of.
We have long wanted to get to a more symbolic URL scheme that would
not be dependent on file location, and we are likely to roll out a
solution for that over time.
The documentation and granular file paths will change over time as
technology changes, docs get reorganized to better explain things and
new requirements come up, but we're trying to make the base paths
stable and to ensure people never get a 404 and always land in an
appropriate location if things have changed.
Also, your new "web app" approach to the docs is not at all useful
for browsing from Mobile Safari.
This should be a bit better with the iPhone doc update released this
morning. Scrolling now works, though reading the HTML on the iPhone is
definitely not a great experience. We're looking at how to improve
that; meantime, especially for learning about a topic, I suggest
trying the PDF version of docs on the phone (the PDF link is in the
upper right corner of the doc) -- I've found that PDF loads quickly,
is much easier to scroll, and is more readable than the HTML right now.
-- Ron
On Sep 4, 2009, at 2:33 PM, Hamish Allan wrote:
On Fri, Sep 4, 2009 at 9:41 PM, Ronald Hayden<email@hidden>
wrote:
I'll reiterate that -- we're about to do a lot of work on how the
reference
is presented, and if we know what people value about the current
layout
(including tooltips), we can incorporate that into our plans.
Tooltips or no tooltips, whatever. What really angers me is that
you've changed the URLs for your entire online documentation, and now
thousands of useful links from blogs are broken.
Please, sort out your URL schema and never change it again.
Impermalinks are so 20th century.
Also, your new "web app" approach to the docs is not at all useful for
browsing from Mobile Safari.
H
_______________________________________________
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