Python primer 1 needs rewrite

[annegentle]

Suggested outline for Python primer 1.

Feel free to adjust as you see reality once you’re in the groove. One other bit of input from instructors is that students tend to re-clone examples, not realizing they already cloned the examples. So the student ends up with multiple directories containing the code samples and get a bit disoriented.

Python Primer Level 1

Step1: Finding and Using the Python Interpreter (was:Versions and Python Interpreter) Step2: (new) Understanding Virtual Environments Step3: (new) Using IDLE: Run from Virtual Environment, Interactive Interpreter, Creating a Python File, Running a Python File Step4: Running a Python File from BASH was:Python Scripts and How they Run including sample Step5: (new) Using the Python Interactive Interpreter (Run, exit the interpreter) Step6: (revise)Basic Data Types(int, float, bool, str) Python Introspection type() was:Python Syntax, (revise) Introduction to Variables (Naming, Defining Python Introspection dir()) was:Scope, Variables, Operators and Simple Conditional Statements Step7: Conditionals (if statements), if syntax, Indentation) was:Python Operators and Conditional Statements Step8: (new) Basic Math Operations Step9: (revise) Basic String Operations was:Python String Concatenation

[annegentle]

@armartirosyan Let's discuss the outline here - feel free to paste in your suggested outline.

[annegentle]

From @armartirosyan

I was reviewing Hank's PPT and learning objectives in DPTF and came up with following outline

Step 1: Getting Started With Python Step 2: Understanding Benefits of Virtual Environments Step 3: Python Interpreter vs Python File Step 4: Identifying Python Data Types and Variables Step 5: Python Operators and Conditional Statements Step 6: Basic Data Operations in Python Step 7: Sneak Peek into Python Functions

Please let me know what are your thoughts about this one.

[annegentle]

Hey @armartirosyan -

Comparing side-by-side, I think that the original TOC separates the interpreter from running files - would you consider doing those in two different steps/files instead of all-in-one in your "Step 3: Python Interpreter vs Python File"? I find that many of our labs don't tell people how to get out of the interpreter with exit() for example. Seems useful to separate those out as the context for each is quite different and instructional.

And then for your "Step 7: Sneak Peek into Python Functions" - would you in that file talk about both math and string functions?

[armartirosyan]

Hi @annegentle,

I will separate the Step 3 into two pieces. Regarding the Step 7: Sneak Peek into Python Functions I was planning to talk about the functions in general and show couple of simple examples. In those examples I can show math and string operations. Would that be okay?

[annegentle]

@armartirosyan -- okay, great, sounds good. Thanks for adjusting -- and let's make sure @denapom11 is good with that as well since teaches it.

[annegentle]

Also @cmlccie Chris Lunsford, could you take a look? Also @armartirosyan might be nice to see a PR or two to find out how this all goes together.

[austinMarcos]

In daily stand-up: @armartirosyan said he is currently working on the virtualization topic. We agreed that changes to the Python primers should initially be committed through a fork/pull-request to the following repo: Stand-alone version:

https://github.com/CiscoDevNet/intro-to-programming

If the changes are approved by @aroach, @denapom11 and others, then those labs will be used as the basis for the DCI track at the DevNet Express event that is scheduled before CLEUR for Jan 26. DNE version:

https://github.com/CiscoDevNet/intro-to-programming-devnet-express

[armartirosyan]

Steps 1-3 are ready for review. PR https://github.com/CiscoDevNet/intro-to-programming/pull/2 has been created.

[armartirosyan]

Hi @annegentle . Thank you very much for your comments, I will address them when I am done with the lab. Meanwhile may I ask you to review the steps 4-6 I just committed those to the repo. Thanks

[armartirosyan]

Hi @annegentle did you get a chance to review steps 7-8? Also I addressed all your comments. Thank you very much

[annegentle]

No, and I will get to it today.

[armartirosyan]

Team,

Python Primer 1 has been published to stage.

https://learninglabs.cisco.com:8867/lab/intro-to-python-primer-1/step/1

[annegentle]

Thanks Armen!

[austinMarcos]

Further reviews need to fork from the upstream repo:

https://github.com/CiscoDevNet/intro-to-programming/

[austinMarcos]

Marcos will assign to @yawming or Denise to test the procedures.

[austinMarcos]

@annegentle will merge or do cleanup edit on PR#6 in intro-to-programming. @austinMarcos will publish the lab tomorrow.

[austinMarcos]

Status update: @annegentle added some more content after PR#6. The lab is stable enough to release and publish on production.

[austinMarcos]

The Primer 1 labs has been published to production (delivered in Barcelona). Closing this issue.