You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+15-10Lines changed: 15 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -6,13 +6,15 @@ Welcome to **Introduction to Python**! Python is one of the most popular and pow
6
6
7
7
There are three possibilities for how you can learn Python with our self-guided course. **JupyterHub** and **Binder** options allow you to run tutorials in the cloud - you do not need to install anything, and no files will be created on your machine. All you need is a web browser and internet connection. However, you need to download Jupyter notebooks you worked in to ensure your work is not lost at the end of each session. The third option is to create a small Python environment and run all tutorials on your machine. There is no difference in what you will learn, and we give you complete freedom to choose how you want to run tutorials.
8
8
9
-
### 1. JupyterHub
9
+
### 1. JupyterHub (ESE students)
10
10
11
11
1.**Create a GitHub account**. In the email you received, we sent you the unique username we generated for you. Create a GitHub account and make sure your GitHub account uses that username.
12
12
13
-
2.**Login to JupyterHub**. On the following link, you can access our JupyterHub server and log in using the GitHub account you just created. After login, it may take some time for JupyterHub to start, so please be patient.
13
+
2.**Login to JupyterHub**. By clicking the following badge, you can access our JupyterHub server and log in using the GitHub account you just created:
14
14
15
-
ESE students [access this repository on JupyterHub here](https://jhub.ese.ic.ac.uk/presessional/hub/user-redirect/git-pull?repo=https%3A%2F%2Fgithub.com%2Fese-msc%2Fintroduction-to-python&urlpath=lab%2Ftree%2Fintroduction-to-python%2F&branch=main).
After login, it may take some time for JupyterHub to start for the first time, so please be patient.
16
18
17
19
**IMPORTANT:** Please note that we do not guarantee your work is backed up. Therefore, we strongly recommend downloading the notebook at the end of each session.
18
20
@@ -30,13 +32,13 @@ You can access Binder by clicking on the *Binder badge*:
30
32
31
33
2.**Clone repository**. In Terminal (Linux and MacOS) or Command Prompt (Windows), navigate to the location where you want the course files to be and run
3.**Install Anaconda**. We recommend installation using conda package manager. If you do not already have it installed, download [Anaconda](https://www.anaconda.com/products/individual) Python 3 for your operating system and follow the instructions to install it. After the installation is complete, in Terminal (Linux and MacOS) or Anaconda Prompt (Windows), navigate to the course directory, create a new conda environment, and activate it using:
37
+
1.**Install Anaconda**. We recommend installation using conda package manager. If you do not already have it installed, download [Anaconda](https://www.anaconda.com/products/individual) Python 3 for your operating system and follow the instructions to install it. After the installation is complete, in Terminal (Linux and MacOS) or Anaconda Prompt (Windows), navigate to the course directory, create a new conda environment, and activate it:
36
38
```
37
39
$ cd path/to/course/directory
38
40
$ conda env create -f environment.yml
39
-
$ conda activate intro-to-python
41
+
$ conda activate introduction-to-python
40
42
```
41
43
42
44
4.**Open Jupyter Notebook**. In the environment you just activated, run:
@@ -48,19 +50,22 @@ $ jupyter notebook &
48
50
49
51
In lectures, after (almost) each exercise, you will notice that there are two cells containing some code. In these cells, we test your solution using two different testing packages:
50
52
51
-
1.**PyBryt**, which analyses your solution and provides you feedback on what is correct in your implementation, as well as what is wrong. Please read PyBryt's feedback carefully and address the `ERROR` messages by modifying your solution.
52
-
2.**okpy**, which validates your final solution and provides you a mark for it.
53
+
1.**PyBryt**analyses your solution and provides you feedback on what is correct in your implementation, as well as what might be wrong. Please read PyBryt's feedback carefully and address the `ERROR` messages by modifying your solution.
54
+
2.**okpy** validates your final solution and provides you a mark for it.
53
55
54
56
It is important to follow the instructions for each exercise exactly and do not change the names of variables, functions, or classes so that tests can analyse your code. Besides, please do not change the content of any of the testing cells.
55
57
56
58
## Support
57
59
58
-
**We encourage questions!!!** If you require support, have questions, want to report a bug, or want to suggest an improvement, please raise an issue in the [course repository](https://github.com/ese-msc/introduction-to-python).
60
+
**We encourage questions!** If you require support, have questions, want to report a bug, or want to suggest an improvement, please raise an issue in the [course repository](https://github.com/ese-msc/introduction-to-python).
59
61
60
62
> **Q:** I don't know where to ask my question. It might be related to something else, but I'm unsure. What should I do?
61
63
> **A:** Open an issue in this repository. This is a safe, respectful space to ask questions and open issues.
62
64
63
65
> **Q:** I've never opened an issue. How do I do it?
64
-
> **A:** Click the `Issues` tab next to top of the page, then click the green `New Issue` button. Ask your question in the title and comment fields, then click `Submit new issue`. Congratulations, you submitted your question! We will try to get back to you shortly. Tip: If you provide [helpful and detailed info]https://fangohr.github.io/computing/smartquestion.html), it is easier for us to understand your question.
66
+
> **A:** Click the `Issues` tab next to top of the page, then click the green `New Issue` button. Ask your question in the title and comment fields, then click `Submit new issue`. Congratulations, you submitted your question! We will try to get back to you shortly. Tip: If you provide [helpful and detailed info](https://fangohr.github.io/computing/smartquestion.html), it is easier for us to understand your question.
67
+
68
+
> **Q:** How can I see if somebody else had the same or similar question?
69
+
> **A:** When you click the `Issues` tab next to top of the page, you can see all issues that are currently open and are being addressed. In addition to them, you can also check the issues that have been resolved in [closed issues](https://github.com/ese-msc/introduction-to-python/issues?q=is%3Aissue+is%3Aclosed).
65
70
66
71
Are you a community member that enjoys sharing your knowledge and helping others solve problems? We encourage you to respond to these issues.
Copy file name to clipboardExpand all lines: index.ipynb
+10-8Lines changed: 10 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -2,8 +2,6 @@
2
2
"cells": [
3
3
{
4
4
"cell_type": "markdown",
5
-
"id": "217f39a2",
6
-
"metadata": {},
7
5
"source": [
8
6
"# Introduction to Python\n",
9
7
"\n",
@@ -24,23 +22,27 @@
24
22
"\n",
25
23
"In lectures, after (almost) each exercise, you will notice that there are two cells containing some code. In these cells, we test your solution using two different testing packages:\n",
26
24
"\n",
27
-
"1. **PyBryt**, which analyses your solution and provides you feedback on what is correct in your implementation, as well as what is wrong. Please read PyBryt's feedback carefully and address the `ERROR` messages by modifying your solution.\n",
28
-
"2. **okpy**, which validates your final solution and provides you a mark for it.\n",
25
+
"1. **PyBryt**analyses your solution and provides you feedback on what is correct in your implementation, as well as what might be wrong. Please read PyBryt's feedback carefully and address the `ERROR` messages by modifying your solution.\n",
26
+
"2. **okpy** validates your final solution and provides you a mark for it.\n",
29
27
"\n",
30
28
"It is important to follow the instructions for each exercise exactly and do not change the names of variables, functions, or classes so that tests can analyse your code. Besides, please do not change the content of any of the testing cells.\n",
31
29
"\n",
32
30
"## Support\n",
33
31
"\n",
34
-
"**We encourage questions!!!** If you require support, have questions, want to report a bug, or want to suggest an improvement, please raise an issue in the [course repository](https://github.com/ese-msc/introduction-to-python).\n",
32
+
"**We encourage questions!** If you require support, have questions, want to report a bug, or want to suggest an improvement, please raise an issue in the [course repository](https://github.com/ese-msc/introduction-to-python).\n",
35
33
"\n",
36
34
"> **Q:** I don't know where to ask my question. It might be related to something else, but I'm unsure. What should I do? \n",
37
35
"> **A:** Open an issue in this repository. This is a safe, respectful space to ask questions and open issues.\n",
38
36
"\n",
39
37
"> **Q:** I've never opened an issue. How do I do it? \n",
40
-
"> **A:** Click the `Issues` tab next to top of the page, then click the green `New Issue` button. Ask your question in the title and comment fields, then click `Submit new issue`. Congratulations, you submitted your question! We will try to get back to you shortly. Tip: If you provide [helpful and detailed info] https://fangohr.github.io/computing/smartquestion.html), it is easier for us to understand your question.\n",
38
+
"> **A:** Click the `Issues` tab next to top of the page, then click the green `New Issue` button. Ask your question in the title and comment fields, then click `Submit new issue`. Congratulations, you submitted your question! We will try to get back to you shortly. Tip: If you provide [helpful and detailed info](https://fangohr.github.io/computing/smartquestion.html), it is easier for us to understand your question.\n",
39
+
"\n",
40
+
"> **Q:** How can I see if somebody else had the same or similar question? \n",
41
+
"> **A:** When you click the `Issues` tab next to top of the page, you can see all issues that are currently open and are being addressed. In addition to them, you can also check the issues that have been resolved in [closed issues](https://github.com/ese-msc/introduction-to-python/issues?q=is%3Aissue+is%3Aclosed).\n",
41
42
"\n",
42
43
"Are you a community member that enjoys sharing your knowledge and helping others solve problems? We encourage you to respond to these issues."
0 commit comments