add my stuff

Akuli · Akuli · commit 7a5b49c50b18 · 2016-09-25T21:31:07.000+03:00
diff --git a/TODO.md b/TODO.md
@@ -1,6 +1,62 @@
-# Things that are not in the tutorial yet
+# Stuff that will (hopefully) be added to this tutorial
 
-- Reading and writing files.
-- Exceptions.
-- Custom classes part 2. Inheritance, multiple inheritance, diamond
-    diagrams, custom exceptions.
+This tutorial is not complete. It still needs:
+
+- Dictionaries and tuples (can be in the same thing since tuples
+    are needed for dict keys)
+- Explain `for a, b in thing` somewhere
+- **More exercises and examples everywhere!**
+- reading and writing files
+    - first of all: what are files, directories/folders and paths
+    - print(..., file=thefile), not thefile.write(...)
+    - show how to iterate over the file and .read() it
+    - why .rstrip('\n') instead of .strip()
+    - files remember their position, reading the same file object twice
+- modules
+    - just files and folders, have a look at Python's lib directory
+    - "batteries included" filosofy
+    - briefly introduce some of the most commonly used standard library
+        modules:
+        - math
+            - it's not a file, what is it?
+        - sys
+            - sys.exit() vs exit()
+        - time
+        - os, os.path, subprocess
+        - random
+        - webbrowser
+    - explain even more briefly and link to documentation/tutorials:
+        - configparser
+        - textwrap
+        - collections, itertools, functools
+        - traceback
+        - types
+        - warnings
+        - json
+    - link to third party modules:
+        - appdirs
+        - requests
+- Exceptions
+- explain bool(x) and why it matters
+- classes part 2
+    - non-public `_variables`
+    - singular inheritance, inheritance of built-in classes
+    - using super
+- quick overview of some of the most useful built-in functions and classes
+    - range
+    - zip
+    - classmethod and staticmethod
+- iterables and iterators: something most Python programmers need to be aware of
+- classes part 3: multiple inheritance
+    - an advanced thing
+    - built-in classes don't use it
+    - diamond diagrams, why to use super()
+- last chapter: "What should I do now?" links to other resources
+    - GUI programming tutorials
+        - easygui
+        - tkinter in effbot (warn the readers about star imports)
+        - pyqt5 in zetcode
+        - gtk+ 3 in readthedocs
+    - a pygame tutorial
+    - David Beazley's metaprogramming and other talks
+    - a regex tutorial
diff --git a/defining-functions.md b/defining-functions.md
@@ -469,3 +469,9 @@ functions.
     defining functions.
 
 Answers for the first and second exercise are [here](answers.md).
+
+***
+
+You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
+
+[Back to the list of contents](README.md)
diff --git a/getting-started.md b/getting-started.md
@@ -202,6 +202,4 @@ Powers are calculated before `*` and `/`, but after `()`.
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](installing-python.md) |
-[Next](the-way-of-the-program.md) |
 [Back to the list of contents](README.md)
diff --git a/handy-stuff-strings.md b/handy-stuff-strings.md
@@ -301,3 +301,9 @@ If you need to know more about formatting I recommend reading
     or `help(str)` when you don't rememeber something about them.
 
 - String formatting means adding other things to the middle of a string.
+
+***
+
+You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
+
+[Back to the list of contents](README.md)
diff --git a/if.md b/if.md
@@ -281,6 +281,4 @@ The answers are [here](answers.md).
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](using-functions.md) |
-[Next](lists.md) |
 [Back to the list of contents](README.md)
diff --git a/installing-python.md b/installing-python.md
@@ -105,6 +105,4 @@ Now you should have Python installed, and you should be able run it.
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](introduction.md) |
-[Next](getting-started.md) |
 [Back to the list of contents](README.md)
diff --git a/introduction.md b/introduction.md
@@ -42,5 +42,4 @@ have learned, and create something with it.
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Next](installing-python.md) |
 [Back to the list of contents](README.md)
diff --git a/lists.md b/lists.md
@@ -93,6 +93,4 @@ we haven't talked about that yet.
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](if.md) |
-[Next](loops.md) |
 [Back to the list of contents](README.md)
diff --git a/loops.md b/loops.md
@@ -264,5 +264,4 @@ Or if you want to clear a list, just use the `.clear()` list method:
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](lists.md) |
 [Back to the list of contents](README.md)
diff --git a/the-way-of-the-program.md b/the-way-of-the-program.md
@@ -40,6 +40,4 @@ learned everything.
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](getting-started.md) |
-[Next](variables.md) |
 [Back to the list of contents](README.md)
diff --git a/todo.md b/todo.md
diff --git a/using-functions.md b/using-functions.md
@@ -160,6 +160,4 @@ Enter something: hello
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](variables.md) |
-[Next](if.md) |
 [Back to the list of contents](README.md)
diff --git a/variables.md b/variables.md
@@ -257,6 +257,4 @@ what you are doing. We'll learn more about it later.
 
 You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).
 
-[Previous](the-way-of-the-program.md) |
-[Next](using-functions.md) |
 [Back to the list of contents](README.md)

Original file line number	Diff line number	Diff line change
`@@ -42,5 +42,4 @@ have learned, and create something with it.`
`42`	`42`
`43`	`43`	`You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).`
`44`	`44`
`45`		`-[Next](installing-python.md) \|`
`46`	`45`	`[Back to the list of contents](README.md)`
Original file line number	Diff line number	Diff line change
@@ -264,5 +264,4 @@ Or if you want to clear a list, just use the `.clear()` list method:
`264`	`264`
`265`	`265`	`You may use this tutorial freely at your own risk. See [LICENSE](LICENSE).`
`266`	`266`
`267`		`-[Previous](lists.md) \|`
`268`	`267`	`[Back to the list of contents](README.md)`