Code review changes and additional edits to links.

Author: BethanyG

concepts/basics/.meta/config.json

@@ -1,5 +1,5 @@
 {
-  "blurb": "Python is a dynamic and strongly typed object-oriented programming language in which variables can be bound and re-bound to any data type. It employs both duck typing and gradual typing (via type hints). Python uses significant indentation to denote code blocks and puts strong emphasis on code readability.",
+  "blurb": "Python is a dynamic and strongly typed programming language in which variables can be bound and re-bound to any data type. It employs both duck typing and gradual typing (via type hints). Python uses significant indentation to denote code blocks and puts strong emphasis on code readability.",
   "authors": ["BethanyG"],
   "contributors": ["cmccandless", "PaulT89"]
 }

concepts/basics/about.md

@@ -1,6 +1,6 @@
 # basics
 
-Python is a [dynamic and strongly][dynamic typing in python] typed [object-oriented][object oriented programming] programming language.
+Python is a [dynamic and strongly typed][dynamic typing in python] programming language.
 It employs both [duck typing][duck typing] and [gradual typing][gradual typing], via [type hints][type hints].
 Imperative, declarative (e.g., functional), and object-oriented programming _styles_ are all supported, but internally **[everything in Python is an object][everythings an object]**.
 
@@ -41,15 +41,15 @@ On the Python track, [variables][variables] are always written in [`snake_case`]
 ## Name Assignment (Variables & Constants)
 
 In Python, there are no keywords used in creating variables or constants.
-Instead, programmer defined [_names_][facts-and-myths-about-python-names] (also called _variables__) can be bound to any type of object using the assignment `=` operator: `<name> = <value>`.
+Instead, programmers can bind [_names_][facts-and-myths-about-python-names] (also called _variables__) to any type of object using the assignment `=` operator: `<name> = <value>`.
 A name can be reassigned (or re-bound) to different values (different object types) over its lifetime.
 
 For example, `my_first_variable` can be re-assigned many times using `=`, and can refer to different object types with each re-assignment:
 
 
 ```python
->>> my_first_variable = 1  # Name bound to an integer object of value one.
->>> my_first_variable = 2  # Name re-assigned to integer value 2.
+>>> my_first_variable = 1  # my_first_variable bound to an integer object of value one.
+>>> my_first_variable = 2  # my_first_variable re-assigned to integer value 2.
 
 >>> print(type(my_first_variable))
 <class 'int'>
@@ -65,7 +65,7 @@ For example, `my_first_variable` can be re-assigned many times using `=`, and ca
 "Now, I'm a string."  # Strings can be declared using single or double quote marks.
 
 import collections
->>> my_first_variable = collections.Counter([1,1,2,3,3,3,4,5,6,7]) # Now the name has been re-bound to a Counter object.
+>>> my_first_variable = collections.Counter([1,1,2,3,3,3,4,5,6,7]) # Now my_first_variable has been re-bound to a Counter object.
 >>> print(type(my_first_variable))
 <class 'collections.Counter'>
 
@@ -106,7 +106,7 @@ Statements for the _body_ of the function begin on the line following `def` and
 
 
 ```python
-# The body of this function is indented by 2 spaces, & prints the sum of the numbers
+# The body of a function is indented by 2 spaces, & prints the sum of the numbers.
 def add_two_numbers(number_one, number_two):
   total = number_one + number_two
   print(total)  
@@ -290,7 +290,6 @@ errors defaults to 'strict'.
 [method objects]: https://docs.python.org/3/c-api/method.html#method-objects
 [module]: https://docs.python.org/3/tutorial/modules.html
 [none]: https://docs.python.org/3/library/constants.html
-[object oriented programming]: https://en.wikipedia.org/wiki/Object-oriented_programming
 [objects]: https://docs.python.org/3/reference/datamodel.html#the-standard-type-hierarchy
 [parameters]: https://docs.python.org/3/glossary.html#term-parameter
 [peps]: https://www.python.org/dev/peps/

concepts/basics/introduction.md

@@ -1,21 +1,24 @@
 # Introduction
 
-Python is a [dynamic and strongly][dynamic typing in python] typed programming language.
-It employs both [duck typing][duck typing] and [gradual typing][gradual typing] via [type hints][type hints].
+Python is a [dynamic and strongly typed][dynamic typing in python] programming language.
+It employs both [duck typing][duck typing] and [gradual typing][gradual typing], via [type hints][type hints].
 
-While Python supports many different programming _styles_, internally **everything in Python is an [object][everythings an object]**.
-This includes numbers, strings, lists, and even functions.
+Imperative, declarative (e.g., functional), and object-oriented programming _styles_ are all supported, but internally **[everything in Python is an object][everythings an object]**.
+
+Python puts a strong emphasis on code readability and (_similar to Haskell_) uses [significant indentation][significant indentation] to denote function, method, and class definitions.
+
+Python was created by Guido van Rossum and first released in 1991.
 
 
 ## Name Assignment (Variables & Constants)
 
-Programmer defined [_names_][facts-and-myths-about-python-names] (also called _variables__) can be bound to any type of object using the assignment `=` operator: `<name> = <value>`.
+Programmers can bind [_names_][facts-and-myths-about-python-names] (also called _variables__) to any type of object using the assignment `=` operator: `<name> = <value>`.
 A name can be reassigned (or re-bound) to different values (different object types) over its lifetime.
 
 
 ```python
->>> my_first_variable = 1  # Name bound to an integer object of value one.
->>> my_first_variable = 2  # Name re-assigned to integer value 2.
+>>> my_first_variable = 1  # my_first_variable bound to an integer object of value one.
+>>> my_first_variable = 2  # my_first_variable re-assigned to integer value 2.
 
 >>> print(type(my_first_variable))
 <class 'int'>
@@ -47,7 +50,7 @@ Statements for the _body_ of the function begin on the line following `def` and
 
 
 ```python
-# The body of this function is indented by 2 spaces, & prints the sum of the numbers
+# The body of a function is indented by 2 spaces, & prints the sum of the numbers.
 def add_two_numbers(number_one, number_two):
   total = number_one + number_two
   print(total)  
@@ -133,3 +136,4 @@ def complex(real=0.0, imag=0.0):
 [parameters]: https://docs.python.org/3/glossary.html#term-parameter
 [return]: https://docs.python.org/3/reference/simple_stmts.html#return
 [type hints]: https://docs.python.org/3/library/typing.html
+[significant indentation]: https://docs.python.org/3/reference/lexical_analysis.html#indentation

concepts/basics/links.json

@@ -1,51 +1,18 @@
 [
-  {
-    "url": "https://docs.python.org/3/",
-    "description": "Python documentation"
-  },
-  {
-    "url": "https://www.python.org/dev/peps/pep-0008/",
-    "description": "PEP 8"
-  },
-  {
-    "url": "https://www.python.org/dev/peps/pep-0020/",
-    "description": "The Zen of Python (PEP 20)"
+  {"url": "https://lerner.co.il/2019/06/18/understanding-python-assignment/",
+    "description": "Reuven Lerner: Understanding Python Assignment"
   },
   {
-    "url": "https://nedbatchelder.com/text/names.html",
-    "description": "Ned Batchelder: Facts and Myths about Python Names."
+    "url": "https://www.youtube.com/watch?v=owglNL1KQf0",
+    "description": "Sentdex (YouTube): Python 3 Programming Tutorial - Functions"
   },
   {
-    "url": "https://realpython.com/python-variables/",
-    "description": "variables in Python"
+    "url": "https://realpython.com/documenting-python-code/#commenting-vs-documenting-code",
+    "description": "Real Python: Commenting vs Documenting Code."
   },
   {
-    "url": "https://docs.python.org/3/tutorial/controlflow.html#defining-functions",
-    "description": "function definition"
-  },
-  {
-    "url": "https://docs.python.org/3/tutorial/controlflow.html#default-argument-values",
-    "description": "default arguments"
-  },
-  {
-    "url": "https://realpython.com/python-comments-guide/#python-commenting-basics",
-    "description": "Comments"
-  },
-  {
-    "url": "https://docs.python.org/3/tutorial/controlflow.html#tut-docstrings",
-    "description": "docstring"
-  },
-  {
-    "url": "https://www.python.org/psf-landing/",
-    "description": "Python Software Foundation"
-  },
-  {
-    "url": "https://www.python.org/dev/peps/",
-    "description": "Python Enhancement Proposals or PEPs"
-  },
-  {
-    "url": "https://docs.python.org/3/reference/datamodel.html",
-    "description": "everything in Python is an object"
+    "url": "https://www.pythonmorsels.com/everything-is-an-object/",
+    "description": "Python Morsels: Everything is an Object"
   },
   {
     "url": "https://stackoverflow.com/questions/11328920/is-python-strongly-typed",
@@ -60,7 +27,11 @@
     "description": "significant indentation"
   },
   {
-    "url": "https://docs.python.org/3/library/doctest.html",
-    "description": "doctests"
+    "url": "https://www.digitalocean.com/community/tutorials/how-to-write-doctests-in-python",
+    "description": "DigitalOcean: How to Write Doctests in Python."
+  },
+  {
+    "url": "https://nedbatchelder.com/blog/201803/is_python_interpreted_or_compiled_yes.html",
+    "description": "Ned Batchelder: Is Python Interpreted or Compiled? Yes."
   }
 ]

exercises/concept/guidos-gorgeous-lasagna/.docs/introduction.md

@@ -24,13 +24,13 @@ On the Python track, [variables][variables] are always written in [`snake_case`]
 
 ## Name Assignment (Variables & Constants)
 
-Programmer defined [_names_][facts-and-myths-about-python-names] (also called _variables__) can be bound to any type of object using the assignment `=` operator: `<name> = <value>`.
+Programmers can bind [_names_][facts-and-myths-about-python-names] (also called _variables__) to any type of object using the assignment `=` operator: `<name> = <value>`.
 A name can be reassigned (or re-bound) to different values (different object types) over its lifetime.
 
 
 ```python
->>> my_first_variable = 1  # Name bound to an integer object of value one.
->>> my_first_variable = 2  # Name re-assigned to integer value 2.
+>>> my_first_variable = 1  # my_first_variable bound to an integer object of value one.
+>>> my_first_variable = 2  # my_first_variable re-assigned to integer value 2.
 
 >>> print(type(my_first_variable))
 <class 'int'>
@@ -62,7 +62,7 @@ Statements for the _body_ of the function begin on the line following `def` and
 
 
 ```python
-# The body of this function is indented by 2 spaces, & prints the sum of the numbers
+# The body of a function is indented by 2 spaces, & prints the sum of the numbers.
 def add_two_numbers(number_one, number_two):
   total = number_one + number_two
   print(total)