Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added some notes about what computer to bring #60

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 23 additions & 7 deletions source/getting_started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,23 +4,37 @@ Getting started
What you'll need
================

A Computer
----------

It does not matter if your computer runs MS Windows, GNU/Linux or Apple OS X.
Python will work on these systems and more.

You also don't need a very powerful machine so don't worry if you computer is a bit old.
If you don't have a computer then a cheap Rasberry Pi computer will work well,
but you'll need to provide a screen, keyboard and mouse.

Refer to the details of the class you are attending for more information.


A Python!
---------

If you haven't yet got python, the latest official installation packages
If you haven't yet got Python, the latest official installation packages
can be found here:

http://python.org/download/

Python 3 is preferable, being the newest version out!
You should install Python 3.

.. note::

On Windows, you'll want to add :program:`Python` to your PATH, so it
can be found by other programs.

When installing Python 3.5 or later, there should be tick box
option to do this on the first page of the installer. Make sure you tick this on.
option to do this on the first page of the installer.
Make sure you tick this on.

And a Code Editor
-----------------
Expand All @@ -30,11 +44,13 @@ many around, and it is one of the most personal choices a programmer can
make - Like a tennis-player choosing their racket, or a chef choosing their
favourite knife. To start off with, you'll just want a basic, easy-to-use one
that doesn't get in your way, but is still effective at writing python code.
Here are some suggestions for those:
Here are some suggestions:

- `Atom`_: A new code editor available for Windows, Mac and Linux. It's
- `Atom`_: A code editor for Windows, Mac and Linux. It's
an open-source project developed by GitHub and is very easy to add
functionality for, with its packages system.
functionality using its packages system. If you add the `Script`
package then you can run the Python file you are working on straight away
using the Ctl+i shortcut.

- `Sublime Text`_: A great all around editor that's easy to use. It's Ctl+B
shortcut lets you run the python file you're working on straight away. Runs
Expand All @@ -60,7 +76,7 @@ Here are some suggestions for those:
.. _Kate: http://kate-editor.org/
.. _Komodo Edit: http://www.activestate.com/komodo-edit

If you'd like our recommendation, try out Sublime Text first.
If you'd like our recommendation, try out Atom first.

.. tip::

Expand Down