flythereddflagg / flythereddflagg.github.io Goto Github PK

there are dashes on each page that must be removed so the viewer sees

Previous: 09 Variables and Memory | Table of Contents | Next: 11 Input and Output

in stead of, currently:

Previous: 09-Variables-and-Memory | Table of Contents | Next: 11-Input-and-Output

https://flythereddflagg.github.io//python_book/site/12-Math-and-Data/#hone-your-skills

inline math does not render on second exercise

https://flythereddflagg.github.io/python_book/site/02-Getting-Started/#troubleshooting-your-installation

This section has "Sample Problem/Sample Solution" perhaps as a placeholder?

Shorten all code blocks so that any line does not exceed 72 characters in length
Also ensure all line numbers are working.

In ch. 14, you state "do not use tabs". I think that deserves a qualification. If you intend to stay with the same code editor, tabs can be an efficient time-saving device. You might consider softening the language to a warning, maybe?

Minor issue, but there's a discrepancy between the code and the print-out of chapter 7 "Escape Characters." Specifically, the code says:

print("Here is a greek eta character: \u03b7")

But the print out reads:

Here is a funny character: η

I would recommend giving the reader some more guidance for the ch. 14 advanced mastery exercise than "There is a problem in the above script if_else.py that can cause errors if we're not careful." This implies that you purposely put a faulty script up there, which may reduce reader confidence in the author? I don't know, it just seemed kinda vague when there could be a really powerful lesson to be learned. Maybe give a hint?

I'm not sure if there's an easy way to do this in github.io, but you might consider adding a glossary for terms that could help readers understand Python-specific (and even programming-specific) terms. Words like "concatenate", etc.

I'd recommend the same, but for acronyms as well.

https://www.python.org/dev/peps/pep-0008/#naming-conventions

add naming conventions reference to names and variables section

https://flythereddflagg.github.io/python_book/site/02-Getting-Started/#python-3-installation

This section has a link for downloading python that is not actually a link. Is this intentional? Perhaps it needs to be linkified.

Ch. 10 - Better String Formatting jumps into the code very quickly. I recommend adding another sentence or two before the code to help the reader know what you mean and what to look for in the code.

Since the assumption is that the reader is new to Python, I recommend adding links to ch. 4 (writing your first script) throughout the book, especially near exercises where you ask the reader to write a script.

Something like: "Stuck? Refer to Chapter 4-hyperlinked for writing and running a script."

There may be other exercises later in the book where you could really help the reader out by encouraging them to revisit previous chapters.