Skip to content

Installation instructions don't explicitly state using Terminal#503

Merged
sigmavirus24 merged 4 commits into
realpython:masterfrom
clebio:master
Dec 7, 2014
Merged

Installation instructions don't explicitly state using Terminal#503
sigmavirus24 merged 4 commits into
realpython:masterfrom
clebio:master

Conversation

@clebio

@clebio clebio commented Dec 5, 2014

Copy link
Copy Markdown

I sent my coworker, Camus, the link for Installing Python on OSX, but it was not obvious to Camus that the instructions for installing brew:

To install Homebrew, simply run
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

were meant to be run in Terminal. I grant that the entire Python Guide might be intended for more experienced developers and that new users could just go to Python.org and download the installer. I would prefer sharing the opinionated guide with a new developer, though, and not have to supplement it with digressions about what the prompt character, $, implies, but is not a part of the command that we paste into Terminal.

The link for install Homebrew in this guide is somewhat stale, but if you follow it through to the Homebrew homepage, the instructions there are a bit closer to what Camus would need (mentions Terminal, doesn't include the prompt character).

Comment thread docs/starting/install/osx.rst Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we should be explaining to users how to open a terminal emulator on their computer. I would say something along the lines of:

open :file:`Terminal.app` or your favorite OSX terminal emulator and run

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Absolutely. Thanks for being supportive of such a minor edit! 6abba86

@sigmavirus24

Copy link
Copy Markdown
Contributor

I totally missed the fact that you updated this @clebio. Thank you! 🍰

sigmavirus24 added a commit that referenced this pull request Dec 7, 2014
Installation instructions don't explicitly state using Terminal
@sigmavirus24 sigmavirus24 merged commit 3c56e57 into realpython:master Dec 7, 2014
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants