Skip to content

Commit 1557d0c

Browse files
committed
Refactored the Introduction section.
Removed redundant links to learning resources and separated the learning, documentation, and news sections in to their own pages.
1 parent 1cb4fa8 commit 1557d0c

File tree

6 files changed

+97
-96
lines changed

6 files changed

+97
-96
lines changed

docs/contents.rst.inc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,9 @@ background information about Python, then focuses on next steps.
99

1010
intro/duction
1111
intro/community
12-
intro/resources
12+
intro/learning
13+
intro/documentation
14+
intro/news
1315

1416

1517
Getting Started
@@ -81,4 +83,4 @@ Contibution notes and legal information are here (for those interested).
8183
:maxdepth: 2
8284

8385
notes/contribute
84-
notes/license
86+
notes/license

docs/intro/documentation.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
Documentation
2+
=============
3+
4+
Official Documentation
5+
----------------------
6+
7+
The official Python Language and Library documentation can be found here:
8+
9+
- `Python 2.x <http://docs.python.org/>`_
10+
- `Python 3.x <http://docs.python.org/py3k/>`_
11+
12+
13+
Read the Docs
14+
-------------
15+
16+
Read the Docs is a popular community project, providing a single location for all documentation of popular and even more exotic Python modules.
17+
18+
`Read the Docs <http://readthedocs.org/>`_
19+
20+

docs/intro/duction.rst

Lines changed: 1 addition & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,4 @@
11
Introduction
22
============
33

4-
5-
Learning Python
6-
:::::::::::::::
7-
8-
Beginners
9-
`````````
10-
11-
* `learnpython.org <http://www.learnpython.org/>`_ - Learnpython.org is an easy non-intimidating way to get introduced to python. The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_ website, it has an interactive python interpreter built into the site that allows you to go through the lessons without having to install Python locally.
12-
13-
* `Dive Into Python 3 <http://diveintopython3.ep.io/>`_ - Dive into Python 3 is a no non-sense approach to Python and is suited for someone that already knows how to program but now wants to learn Python.
14-
15-
16-
Learn Python the Hard Way
17-
-------------------------
18-
19-
20-
Advanced
21-
````````
22-
23-
Pro Python
24-
----------
25-
26-
Expert Python Programming
27-
-------------------------
4+
Someone should write a general blurb introducing the Python language here

docs/intro/learning.rst

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
Learning Python
2+
===============
3+
4+
Beginner
5+
--------
6+
7+
Learn Python Interactive Tutorial
8+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9+
10+
Learnpython.org is an easy non-intimidating way to get introduced to python. The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_ website, it has an interactive python interpreter built into the site that allows you to go through the lessons without having to install Python locally.
11+
12+
`Learn Python <http://www.learnpython.org/>`_
13+
14+
Learn Python the Hard Way
15+
~~~~~~~~~~~~~~~~~~~~~~~~~
16+
17+
This is an excellent beginner programmer's guide to Python. It covers "hello world" from the console to the web.
18+
19+
`Learn Python the Hard Way <http://learnpythonthehardway.org/book/>`_
20+
21+
22+
Crash into Python
23+
~~~~~~~~~~~~~~~~~
24+
25+
Also known as *Python for Programmers with 3 Hours*, this guide gives experienced developers from other languages a crash course on Python.
26+
27+
`Crash into Python <http://stephensugden.com/crash_into_python/>`_
28+
29+
30+
Dive Into Python 3
31+
~~~~~~~~~~~~~~~~~~
32+
33+
Dive Into Python 3 is a good book for those ready to jump in to Python 3. It's a
34+
good read if you are moving from Python 2 to 3 or if you already have some
35+
experience programming in another language.
36+
37+
`Dive Into Python 3 <http://diveintopython3.ep.io/>`_
38+
39+
40+
Advanced
41+
--------
42+
43+
Pro Python
44+
~~~~~~~~~~
45+
46+
TODO: Write about this book
47+
48+
`Pro Python <http://propython.com/>`_
49+
50+
Expert Python Programming
51+
~~~~~~~~~~~~~~~~~~~~~~~~~
52+
53+
TODO: Write about this book
54+
55+
`Expert Python Programming <http://www.packtpub.com/expert-python-programming/book>`_

docs/intro/news.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
News
2+
====
3+
4+
Planet Python
5+
~~~~~~~~~~~~~
6+
7+
This is an aggregate of Python news from a growing number of developers.
8+
9+
`Planet Python <http://planet.python.org>`_
10+
11+
/r/python
12+
~~~~~~~~~
13+
14+
/r/python is the Reddit Python community where users contribute and vote on
15+
Python-related news.
16+
17+
`/r/python <http://reddit.com/r/python>`_

docs/intro/resources.rst

Lines changed: 0 additions & 70 deletions
This file was deleted.

0 commit comments

Comments
 (0)