search

data-lessons / library-python-intro-DEPRECATED

REPO NOW MOVED > https://github.com/LibraryCarpentry/lc-python-intro
https://github.com/LibraryCarpentry/lc-python-intro
Other
1 stars 11 forks source link

simplifying language on syntax errors #44

Closed elliewix closed 7 years ago

elliewix commented 7 years ago

Tried to simplify the language in the header. I also wanted to change this statement: "Won’t even try to run the program if it can’t be parsed" Python has to run the program up until that point to even see the error, but the script will shut down if the line of code can't be parsed. So this statement is very confusing.

I also fussed with the wording to focus more on linguistic synonyms, which usually hits better with a librarian crowd.

richyvk commented 7 years ago

Is the term "grammar rules" a bit confusing? People might think it means English grammar, not Python grammar?

elliewix commented 7 years ago

You're right, it could perhaps use some more context. However, I usually talk about syntax errors as part of a larger metaphor that, like all human languages, programming languages have specific grammar and punctuation rules. You get errors or crashes when those are violated. This usually hits well for librarians because many are either from English, literature, or have degrees in other languages.

richyvk commented 7 years ago

Did a quick edit - if your happy with it I'll merge it in.