Nice start!!!! http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst File Doc/howto/idle.rst (right): http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst#newcode4 Doc/howto/idle.rst:4: In this guide, we take a look at the basic features of `IDLE` I would replace the word "guide" with FAQ throughout the document because you are adding a new FAQ after all right? http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst#newcode6 Doc/howto/idle.rst:6: are suitable for a new Python programmer. The scope of this document which is suitable for a beginner Python programmer. http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst#newcode8 Doc/howto/idle.rst:8: write programs using the editor and running it. The scope of this document is intentionally limited to demonstrate the use of the IDLE editor to create Python programs then run those programs in the IDLE shell. http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst#newcode28 Doc/howto/idle.rst:28: I wonder if you should add a section for Mac? The Mac is a little tricky because every version of OS X has Python built in, but I don't use that version because I am always running the latest and greatest to help contribute. The question is does the Python community support the Apple version of Python or recommend that a official Python version be installed? I am not sure. Here is more information to start your research http://www.python.org/getit/mac/ http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst#newcode43 Doc/howto/idle.rst:43: You can go back to previous commands using the ``UP`` arrow key and At the moment the UP and DOWN arrow keys do not function the way you describe. Although we are talking about changing this behavior and I hope we do soon :-). Basically the up history is alt-p and the down history is alt-n currently. The arrow keys will move a user around then they can select a previous line and press enter and that line will be copied to the >>> prompt for execution or editing. I am doing a horrible job explaining it but that is the default behavior at the moment. http://bugs.python.org/review/17583/diff/7736/Doc/howto/idle.rst#newcode116 Doc/howto/idle.rst:116: accordingly. I would add a few sentences about hi-lighting code sections then using Indent Region (ctrl-]) and Dedent region (ctrl-[). Also the comment code section is handy for testing and debugging. As Ezio explained you have the room so go for it! http://bugs.python.org/review/17583/