• 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 still not being installed
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation still not being installed


  • Subject: Re: Documentation still not being installed
  • From: Jean-Denis MUYS <email@hidden>
  • Date: Thu, 04 Aug 2011 07:56:22 +0000
  • Thread-topic: Documentation still not being installed


On 3 août 2011, at 20:57, G S wrote:

I didn't run Xcode, nor should I have to.  Nowhere did the installer
say that I needed to, so why would I?

Duh! You run the Xcode installer and you don't see why you would launch the product you just installed?

 I was setting up the machine
from scratch with a new Lion installation, going through all the
applications I needed and installing them.  Now I'm supposed to run
every single app on the machine, looking for Easter-egg installations?

This design is irresponsible

And your arrogance is overwhelming. If you had researched your issue, or perhaps spent *just* a few weeks reading around the developer community, you would have:

1- Known about how Xcode and its installer handle the documentation
2- Known that many many developers have the exact opposite opinion than yours for reasons that have been detailed time and time again

So here you come out from nowhere and you bark "irresponsibility"?

and lacks common sense.

Common sense is that the potential for a break down grows exponentially with the size of the installer. That's why many developers have filed bug reports requesting Apple to split its Xcode installer in smaller pieces, usually by separating the SDK from the tools.

 If I'm
downloading a massive SDK, it stands to reason I've allocated the time
or bandwidth to do so.

No it doesn't. Many developers live in a world where bandwidth is a precious commodity, that must no be wasted. Some of us have flaky connections that will disconnect any time for any or no reason. When that happens, it's likely that the download has to be restarted from scratch. Some of us have very slow connections, where downloading 2 GB takes ages, let alone 10 GB. Including huge documentation within will waste bandwidth in many cases and require answering 2 questions:

- What when Xcode is updated, but not the documentation?
- What when the documentation is updated, but not Xcode?

 Why would I then want to be surprised at some
later date with another download for the documentation?

Perhaps because the documentation is a moving target and is updated far more often than the tools? And if you are really *surprised*, then you are a newbie. Newbies are welcome, but should not come on high horses.


My scenario provides the obvious example of why that's unacceptable.

Your scenario is about the most contrived I can imagine. There are far more common scenarios that would suggest doing exactly the opposite of what you demand.

And even if I had Internet access, I might be at some remote location
with a relatively slow mobile data card.  Or, heaven forbid, I have
some work to do NOW and I need to look something up without waiting
for yet another massive download.

If you had any experience, you would know that the documentation is *also* available instantly for querying online. You are welcome. But even then, adding the documentation to Xcode would make for an even more massive download. So even your potential situation here would not be helped by including the doc within.

 These are all very good reasons

not

that the current design is stupid,
and I can't think of one reason
that it's wise.  
The idea of saving download time initially just
doesn't stand up to even superficial consideration.  
Unless the
contention is that the majority of users will NEVER use the
documentation.

I did file a bug on this, but it's sad that I had to.

No need to comment further on all that.


 _______________________________________________
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

  • Follow-Ups:
    • Re: Documentation still not being installed
      • From: David Frantz <email@hidden>
References: 
 >Documentation still not being installed (From: G S <email@hidden>)
 >Re: Documentation still not being installed (From: Ronald Hayden <email@hidden>)
 >Re: Documentation still not being installed (From: G S <email@hidden>)

  • Prev by Date: Re: Universal Builds
  • Next by Date: Does XCode 4.1 support 32-bit targets?
  • Previous by thread: Re: Documentation still not being installed
  • Next by thread: Re: Documentation still not being installed
  • Index(es):
    • Date
    • Thread