Skip to content

Commit 290837e

Browse files
committed
reorg ToC and pages
1 parent 12f7295 commit 290837e

22 files changed

Lines changed: 84 additions & 117 deletions

‎content/pages/01-introduction/02-python-programming-language.markdown‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ involves nested loops with conditionals that can be difficult for code
6060
readers to properly evaluate.
6161

6262

63-
## Example code
63+
## Example comprehensions code
6464
List comprehension:
6565

6666
>>> double_digit_evens = [e*2 for e in range(5, 50)]
@@ -79,7 +79,7 @@ Dictionary comprehension:
7979
{1: 10, 2: 20, 3: 30, 4: 40, 5: 50, 6: 60, 7: 70, 8: 80, 9: 90, 10: 100}
8080

8181

82-
## General Python language resources
82+
### General Python language resources
8383
* The [online Python tutor](http://www.pythontutor.com/) visually walks
8484
through code and shows how it executes on the Python interpreter.
8585

@@ -116,7 +116,7 @@ Dictionary comprehension:
116116
is a summary of what one developer learned about PyPy while researching it.
117117

118118

119-
## Python ecosystem resources
119+
### Python ecosystem resources
120120
There's an entire page on [best Python resources](/best-python-resources.html)
121121
with links but the following resources are a better fit for when you're past
122122
the very beginner topics.

‎content/pages/01-introduction/03-why-use-python.markdown‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ beginner-friendly devices such as the
2424
<div class="well see-also">If you're learning about why to use Python you should also take a look at <a href="/best-python-resources.html">the best Python resources</a> and read <a href="/web-development.html">more about web development</a>.</div>
2525

2626

27-
### Python's programming language popularity
27+
## Python's programming language popularity
2828
Several programming language popularity rankings exist. While it's
2929
possible to criticize that these guides are not exact, every ranking shows
3030
Python as a top programming language within the top ten, if not the top five
@@ -66,7 +66,7 @@ developers are using a language. However, the aggregate view shows that Python
6666
remains a stable programming language with a growing ecosystem.
6767

6868

69-
### Why does the choice of programming language matter?
69+
## Why does the choice of programming language matter?
7070
Programming languages have unique ecosystems, cultures and philosophies
7171
built around them. You will find friction with a community and difficulty
7272
in learning if your approach to programming varies from the philosophy of
@@ -107,7 +107,7 @@ displays [The Zen of Python](https://www.python.org/dev/peps/pep-0020/).
107107
Namespaces are one honking great idea -- let's do more of those!
108108

109109

110-
### More perspectives on why to use Python
110+
## More perspectives on using Python
111111
Programming language rankings and the philosophy behind a language
112112
provide solid initial data points for why you should learn Python.
113113
These resources also give perspectives on why people switched from other

‎content/pages/01-introduction/04-python-2-or-3.markdown‎

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ may have to sometimes use both Python 2 and 3 because parts of these
3939
libraries are lagging in full Python 3 support.
4040

4141

42-
### Visualizations and Projects
42+
## Visualizations and Projects
4343
Since upgrading from Python 2 to 3 has been such a huge undertaking within
4444
the community, many projects have sprung up to make the transition easier.
4545

@@ -171,5 +171,3 @@ should upgrade as soon as possible.
171171
is a great slideshow with code snippets that show useful new features
172172
of Python 3 that are not available in 2.x such as keyword-only
173173
arguments, chained exceptions and the `yield from` keyword.
174-
175-

‎content/pages/01-introduction/05-enterprise-python.markdown‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ appropriate for this list, [contact me](/about-author.html) to let me know:
110110
languages as is often the case in large organizations.
111111

112112

113-
## Enterprise Python software development resources
113+
### Enterprise Python software development resources
114114
The following articles cover topics in enterprise development that are
115115
often not discussed when dealing with standard Python development.
116116

‎content/pages/01-introduction/06-community.markdown‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ causes decline over time as the original community members move on to new
6262
projects and no new members take their place.
6363

6464

65-
### Conferences and events
65+
## Conferences and events
6666
The Python online community has fantastic resources for learning but talking
6767
to your fellow developers in-person at conferences, meetups and hackathons
6868
is a crucial way to discover new tools and coding approaches. The following

‎content/pages/01-introduction/07-companies.markdown‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Python to script the server's configuration! Python has a habit of getting
2525
in everywhere regardless of whether the usage is intentional.
2626

2727

28-
### Financial institutions
28+
## Financial institutions
2929
Python is widely-used across financial institutions, whether they are
3030
hedge funds, large banks or regulators (see "Government Agencies" section
3131
below).
@@ -50,7 +50,7 @@ below).
5050
and [configuring DNS](https://www.paypal-engineering.com/2015/12/16/enterprise-overhaul-resolving-dns/).
5151

5252

53-
### Large tech companies
53+
## Large tech companies
5454
Large technology companies tend to be polyglot (use many programming
5555
languages rather than standardizing on one), with Python either as a
5656
primary language or the "glue" that helps all the other languages fit
@@ -108,7 +108,7 @@ stacks.
108108
[in this awesome overview post titled "What its like to be a developer at..."](https://increment.com/development/what-its-like-to-be-a-developer-at/).
109109

110110

111-
### Government agencies
111+
## Government agencies
112112
Python usage in government agencies is widespread despite the reputation of
113113
agencies as stodgy late technology adopters. Organizations range from
114114
financial industry regulators like the SEC and CFPB, to intelligence agencies
@@ -142,7 +142,7 @@ like the CIA, FBI and NSA.
142142
National Institute of Standards and Technology (NIST).
143143

144144

145-
### Industry-specific Python guides
145+
## Industry-specific Python guides
146146
Python is so widely used across various industries that developers have
147147
written guides specific to their occupations for how to use Python. The
148148
following resources are guides for using Python in astronomy, social

‎content/pages/01-introduction/08-best-python-resources.markdown‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -187,7 +187,7 @@ section for a curated list of both Python-specific and general software
187187
development podcasts.
188188

189189

190-
### Newsletters
190+
## Newsletters
191191
Python's active community constantly publishes new tutorials and
192192
walkthroughs. It is easier to keep up if you follow along by subscribing
193193
to several email newsletters that round up and curate the best new

‎content/pages/01-introduction/09-best-python-videos.markdown‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ talks from the past several years.
2020
<div class="well see-also">Check out the <a href="/best-python-resources.html">best Python resources</a> for links to great books and articles as well as <a href="/best-python-podcasts.html">must-listen Python podcasts</a> for audio-only shows.</div>
2121

2222

23-
### Web development videos
23+
## Web development videos
2424
The following [web development](/web-development.html) videos cover the broad
2525
topics of using [web frameworks](/web-frameworks.html) like
2626
[Django](/django.html), [Flask](/flask.html), [Pyramid](/pyramid.html) and
@@ -101,7 +101,7 @@ topics of using [web frameworks](/web-frameworks.html) like
101101
[web framework](/web-frameworks.html) topics.
102102

103103

104-
### Core Python language videos
104+
## Core Python language videos
105105
The core Python programming language has many new features now that almost
106106
all [community](/python-community.html) resources are working on
107107
[Python 3](/python-2-or-3.html) instead of split across legacy 2.x branches.
@@ -144,7 +144,7 @@ well.
144144
lecture videos and exercises for learning Python.
145145

146146

147-
### Video compilations
147+
## Video compilations
148148
All major Python conferences, as well as most regional ones, release
149149
technical talk videos for free. These sites either aggregate the thousands
150150
of videos that have been released or are lists from specific conferences

‎content/pages/01-introduction/10-best-python-podcasts.markdown‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This page contains a list of active Python-specific and software engineering
1717
high-quality podcasts.
1818

1919

20-
### Python-specific podcasts
20+
## Python-specific podcasts
2121
These podcasts are run and recorded by Python developers who focus on
2222
topics that are important to our field. Each podcast series has a long
2323
list of previously-recorded episodes that are still relevant even if they
@@ -50,7 +50,7 @@ listen and learn.
5050
influential [Python community](/python-community.html) members.
5151

5252

53-
### Favorite podcast episodes
53+
## Favorite podcast episodes
5454
Here are a list of my favorite episodes from various Python podcasts before
5555
we dive into entire podcast recommendations in the next section. Dig into
5656
these episodes to get a feel for various personalities and styles in
@@ -99,7 +99,7 @@ podcast presentation.
9999
<div class="well see-also">If you prefer to learn Python by reading check out the <a href="/best-python-resources.html">best Python resources page</a> or <a href="/table-of-contents.html">view all topics</a>.</div>
100100

101101

102-
### General software development podcasts
102+
## General software development podcasts
103103
These podcasts are not specific to Python but cover relevant software
104104
engineering topics and often have episodes on Python topics. At the
105105
very least you will become a better general software developer by
@@ -150,7 +150,7 @@ listening and learning from them.
150150
and DevOps-related topics.
151151

152152

153-
### Data science and analysis podcasts
153+
## Data science and analysis podcasts
154154
The [data](/data.html) science community does not only use Python as its
155155
core programming language but it plays a big role in almost every
156156
organization performing data analysis. The following podcasts cover

‎content/pages/02-development-environments/00-development-environments.markdown‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ as a complete integrated development environment (IDE) such as
2222
operating system.
2323

2424

25-
### Why is a development environment necessary?
25+
## Why is a development environment necessary?
2626
Python code needs to be written, executed and tested to build
2727
applications. The text editor provides a way to write the code. The
2828
interpreter allows it to be executed. Testing to see if the code does what
@@ -31,7 +31,7 @@ you want can either be done manually or by unit and functional tests.
3131
<div class="well see-also">While you're learning about development environments be sure to check out information on <a href="/vim.html">Vim</a> and <a href="/emacs.html">Emacs</a>.</div>
3232

3333

34-
### A development environment example
34+
## An example development environment
3535
Here's what I (the author of Full Stack Python,
3636
[Matt Makai](/about-author.html)) use to develop most of my Python
3737
applications. I have a Macbook Pro with Mac OS X as its base operating
@@ -49,7 +49,7 @@ That's a common set up but you can certainly write great code with a much
4949
less expensive set up or a cloud-based development environment.
5050

5151

52-
### Other developer's environments
52+
## Other developers' environments
5353
Often the best way to figure out how to get comfortable in your own
5454
development environment is to see examples of how other experienced
5555
developers have set up their configurations. The following posts contain
@@ -73,7 +73,7 @@ publicly document.
7373
Python 2 & 3.
7474

7575

76-
### Cloud hosted dev environments
76+
## Cloud hosted dev environments
7777
Several cloud-based development environments have popped up over the past
7878
several years. These hosted environments can work well when you are learning
7979
or stuck on a machine with a web browser but otherwise no administrative

0 commit comments

Comments
 (0)