On Tue, Jan 1, 2013 at 9:43 PM, Miriam Hochwald <miriamhochwald_at_gmail.com>wrote:
> Hello Justin,
>
> Actually the INSTALL docs ... whilst detailed make me phobic. It seems to
> target the audience that likes to tinker, rather than just click and oh ...
> there it is (think iPad users ... which is most of the world). It might be
> better to have something other than plain text, in a kind of "Wizard"
> approach - problem solver perspective.
>
> A simple piece of "stupidity" to a Noob which I have just encountered is
> ... use of 'make' - well, if you don't have a C complier installed, then
> "ba-bum!" no fun. So, then I needed to go back into the plain text doc (no
> highlighters or formatting assistance) and then go ... hmmm... C compiler,
> C compiler. Googles gcc. Googles Xcode. Needs updated Mac OS. Downloads
> updated Mac OS - updates Mac. Think she has lost *all* her files - Panic!
> Finds files - "phew!" Downloads Eclipse - chooses version and updates.
> Computer doesn't like update etc. ... etc. Ok ... so you see the picture.
> Eventually when I finish updating Xcode and obtain gcc I will go back to
> that unformatted plain text and read the next line. Convoluted.
>
If you're up for creating one, I'm sure we'd find a home for a separate
document that goes soup-to-nuts on what needs to be installed. I
definitely agree that we make some assumptions about the environment. =)
At times, I wish we had a comprehensive toolchain install doc for Windows
that was clear; so, it's probably reasonable to assume that there could be
a use for a clear bootstrap doc for Mac too for devs who might not be as
familiar with Mac OS X and its toolchain.
Keep chugging along! -- justin
Received on 2013-01-02 12:42:41 CET