On Tue, Jan 1, 2013 at 9:43 PM, Miriam Hochwald <miriamhochw...@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
