Éric Araujo added the comment:

Goal #1: set up Python I believe http://docs.python.org/dev/using/ covers this.

Goal #2: prepare a text editor This is missing from our docs. (My first thought was that it was out of scope, but for complete beginners, it would be nice to give a few pointers.)

Goal #3: practice starting and exiting Python The tutorial has one page about that.

Goal #4: practice navigating the computer from a command prompt Out of scope?

Goal #5: practice running Python code from a file This is probably in the tutorial or using docs, I have to check.

Goal #6: get dependencies installed for the Saturday projects This used to be non-standard, but now that we have packaging and pysetup, I translate this item to a doc bug: Explain how to use pysetup to get dependencies (in using, I think).

Goal #7: start learning Python! Goal #8: Checkoff Nothing to add, IMO.

---------- nosy: +eric.araujo _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Changes by Adam Woodbeck : ---------- nosy: +adam.woodbeck _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Éric Araujo added the comment: IMO we don’t need HOWTOs that duplicate existing docs, but we may need additions to the existing tutorial and “using” docs. See http://bugs.python.org/issue12436#msg140141 ---------- _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Éric Araujo added the comment: I propose that we just narrow the scope of this report. If you agree with my earlier message, the current docs just need a few patches: - How to prepare a text editor - How to run Python code from a file (if the tutorial or using docs don’t already have it). It would also be nice to have feedback from beginners about our tutorial and using docs: Are they comprehensive and easy to find? ---------- keywords: +easy status: pending -> open title: Provide reference to detailed installation instructions -> Missing items in installation/setup instructions versions: +Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Éric Araujo added the comment: Thanks Mike! So the first item is covered (at least for UNIX, can you check the Windows docs too?), but not the second. The item you linked to explains how to modify a script so that it’s possible to run ./script on Unix, but does not give an actual example of running it, nor does it explain “python script” or “python script.py” or “python -m module”. ---------- _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Éric Araujo added the comment:

http://docs.python.org/dev/using/windows.html Makes no reference to preparing a text editor. This I could help with but... Cool, please follow the guidelines in the devguide to make a patch for 3.2. It should be something short, like the unix docs, mostly to recommend Notepad++ I think.

For Windows users, added a section about how to use a terminal and possibly a link to PowerShell would be another good addition IMO.

Some one else would have to write this part unless you can give me some info about how it should be worded. I’ll propose a patch.

---------- _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Ezio Melotti added the comment:

In addition to Notepad++ do you think it would be a good idea to at least mention Vim and Emacs with a disclaimer about the learning curve?

I'm not sure how many windows user use Vim/Emacs. Maybe PyScripter could be mentioned too, but I'm not sure how popular it is and if there are better alternatives.

Do you think it would be a good idea to add instructions on how to add Python to the Path in Windows?

Yes, but isn't there a script somewhere that does that already? ---------- nosy: +ezio.melotti _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Antoine Pitrou added the comment: Oops. I just noticed this issue is not talking about the devguide, but the general docs. Please ignore the message above. ---------- _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Mike Hoy added the comment: Here is what I have so far:

For Windows users, added a section about how to use a terminal

How to use a terminal Open a command prompt: * On Windows Vista or Windows 7: click on the Start menu (the Windows logo in the lower left of the screen), type cmd into the Search field directly above the Start menu button, and click on "cmd" in the search results above the Search field. * On Windows XP: click on the Start menu (the Windows logo in the lower left of the screen), click on "Run...", type cmd into the text box, and hit enter. Commands used in terminal * cd C:\ - Puts you in the root directory of the C drive. * cd Python32 - Puts you in the directory where Python 3.2 is installed. * dir - This command lists the contents of the Python32 directory. * python - This command will invoke python.exe and bring up the interpreter.

a link to PowerShell

Windows PowerShell Windows PowerShell is a task-based command-line shell and scripting language designed for system administration. It can be obtained here: http://technet.microsoft.com/en-us/library/bb978526.aspx. ---------- _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Éric Araujo added the comment: Thanks, I will take all contributions and suggestions and propose one patch. ---------- assignee: docs@python -> eric.araujo _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Mike Hoy added the comment:

Thanks, I will take all contributions and suggestions and propose one patch.

I am able to start working on this issue again, Eric. If you want to give me the status of your patch I can either help you finish it up or I can make one this week. ---------- _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Mike Hoy added the comment: Here is a patch for just Notepad++. ---------- keywords: +patch Added file: http://bugs.python.org/file26891/issue12436-notepad_plus_plus.diff _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Mike Hoy added the comment: Wrapped my text columns to 80. Ignore v2. ---------- Added file: http://bugs.python.org/file26904/issue12436-notepad_plus_plus_3.diff _______________________________________ Python tracker http://bugs.python.org/issue12436 _______________________________________

Change by Irit Katriel : ---------- title: Missing items in installation/setup instructions -> [doc] Missing items in installation/setup instructions versions: +Python 3.10, Python 3.8, Python 3.9 -Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker https://bugs.python.org/issue12436 _______________________________________