Lab 15: Python 1 (The NEW Lab by Max and Andy)

[lmock]

• [x] The yellow background on this page needs to be changed. It's hard to see the text on the inside. Perhaps change it to black so that it's easier to see the colorful font.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/introduction_to_besides_blocks.html?topic=berkeley_bjc/python/besides-blocks-welcome.topic&step=0&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html

[lmock]

• [x] "In this lab, you will get to practice writing python in the interpreter and in a text file."

Explain what an interpreter is on this page. The interpreter is never actually explained on any of the following pages, not even on the second page of the lab.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/introduction_to_besides_blocks.html?topic=berkeley_bjc/python/besides-blocks-welcome.topic&step=0&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html

[lmock]

• [x] format the word "Snap!" the correct way: "You will see python code side by side with snap code throughout this lab because, although you may not believe it, anything that can be built in snap can also be created in python and vice versa."

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/introduction_to_besides_blocks.html?topic=berkeley_bjc/python/besides-blocks-welcome.topic&step=0&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html

[lmock]

• [x] The green box around syntax is unnecessary.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/introduction_to_besides_blocks.html?topic=berkeley_bjc/python/besides-blocks-welcome.topic&step=0&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html

[lmock]

• [x] Fix the image / text borders. Also, that Terminal image overruns the Windows section and should only be contained to the Mac OSX section since it doesn't look like that or is called that on Windows.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/open_shell_and_python.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=1

[lmock]

• [x] " On Mac and Linux[INSERT COMMA] the Terminal application can be accessed from the Applications folder or using a quick-search function."

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/open_shell_and_python.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=1

[lmock]

• [x] "Windows also has an interface similar to the terminal, but it is called the CMD command line."

Well for one, people who have Windows computer won't read the section about Macs, so try to make this section non-dependent on reading the Mac section.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/open_shell_and_python.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=1

[lmock]

• [x] "The next step is to open the python "interpreter". On the command line type python3 and hit the Enter key. The "3" indicates the version of python we will be using in this lab. You should see something similar to the following:"

^ Doesn't work on Windows. This does:

[lmock]

• [ ] Argh what does the unix part mean??? Student's won't know -- "From here you won't be able to run any unix command."

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/open_shell_and_python.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=1

[lmock]

• [x] This page doesn't exist...and the next button on this page links to the page that doesn't exist: https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/open_shell_and_python.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=1

https://inst.eecs.berkeley.edu/~cs10/labs//bjc-r/cur/programming/python/python_syntax_and_operators.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=2

[lmock]

• [x] General note here -- make sure you're consistent with capitalizing / not capitalizing Python on ALL pages of the lab. The inconsistencies are pretty scattered throughout all pages.

[lmock]

• [x] Spell summary correctly: "Here's a quick summarry of many of the useful operators in Python shown side by side with their Snap equivalent. "

https://inst.eecs.berkeley.edu/~cs10/labs//cur/programming/python/python_syntax_and_operators.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=2

[lmock]

• [x] Fix "snap" and "python"

"We can see that python operators like greater than or equal to >= can save us alot of time when writing our code, since in snap we would have needed to drag out multiple blocks."

https://inst.eecs.berkeley.edu/~cs10/labs//cur/programming/python/python_syntax_and_operators.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=2

[lmock]

• [x] Fix the humongous white space

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/running_script_from_command_line.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=4

[lmock]

• [ ] Throw in a couple commas or break up the sentence. I also don't see why the blue box is needed.

To navigate to a particular python file we will need to make use of the following shell commands (whenever we say "enter a command" this means type the command and then press enter to execute it):

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/running_script_from_command_line.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=4

[lmock]

• [ ] ls isn't the command on Windows! It's "dir"

^ Generally speaking, you need to make this lab Windows compatible.

"First, enter the command ls to view a list of all of the files and directories that are located in your current directory. If you see a ~ next to your user name (alonzo is the username below) then we are in our home directory. To go directly to your home directory enter the command cd. When your enter ls in your home directory you should see something similar to the following:"

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/running_script_from_command_line.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=4

[lmock]

• [x] Fix "Finally, let’s make a directory"

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/running_script_from_command_line.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=4

[lmock]

• [x] I don't get what the green box on the bottom of this page is for. It's use throughout the lab isn't consistent.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/running_script_from_command_line.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=4

[lmock]

• [x] WHY would you EVER name a file "virus"????? I wouldn't download that file. Name it something else.

https://inst.eecs.berkeley.edu/~cs10/labs/prog/python/virus.py

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/finding_a_bar.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=5

[lmock]

• [ ] Spacing between sentences: "Finally, let’s make a directory that will hold our python files.We can enter the command"

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/running_script_from_command_line.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=4

[lmock]

• [ ] Comma after end )

"There are many text editors available, (NotePad++, Emacs, Xcode, etc.) but in this lab we'll be using SublimeText 3."

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/finding_a_bar.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=5

[lmock]

• [x] Capitalize "sublime" -- and make sure it's capitalized all throughout the lab.

Open up sublime and then open virus.py.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/finding_a_bar.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=5

[lmock]

• [ ] "Open up sublime and then open virus.py."

Make the directions more clear -- as in, open up virus.py in Sublime.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/finding_a_bar.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=5

[lmock]

• [ ] Typo in virus.py

"Try to put you answers in the correct section that we have designated by reading the comments."

YOUR

https://inst.eecs.berkeley.edu/~cs10/labs/prog/python/virus.py

[lmock]

• [ ] Typo in virus.py

"Good Luck and don't worry this file isn't actually a computer virus...but then again how much do yo trust us?"

1. don't worry [COMMA]
2. YOU

https://inst.eecs.berkeley.edu/~cs10/labs/prog/python/virus.py

[lmock]

• [ ] Blue box isn't necessary at the top of the page.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/define_simple_function.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=6

[lmock]

• [ ] Green box at the top of the page isn't necessary.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/printing_while_loops.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=8

[lmock]

• [x] The Snap! blocks are too big :( they need to decrease in size a bit.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/printing_while_loops.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=8

[lmock]

• [ ] Insert a comma

"As you saw on the previous page[COMMA] the print statement converted the number i into a string and printed it to the command line."

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/printing_while_loops.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=8

[lmock]

• [ ] Does "output" need to be bolded? Also end of the sentence should end with a :

"Output: Calling the python count_up(num) function with an input produces the following result."

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/printing_while_loops.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=8

[lmock]

• [x] I thought the count up function was in the virus.py file but it isn't. Students will probably try running virus.py on their own only to find that it doesn't exist. :/ Since you do show it below, perhaps in the beginning, you can add a part that's says something like look further on the page for the code.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/printing_while_loops.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=8

[lmock]

• [ ] Spacing between sentences:

"Remember back to the discussion of the range(x,y) function.It produces a list that does not include y. "

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/printing_while_loops.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=8

[lmock]

• [ ] Make an extra column between Python and Operators so that it doesn't look like one continuous row for each operator in the first column. And bold column titles.

https://inst.eecs.berkeley.edu/~cs10/labs/cur/programming/python/python_syntax_and_operators.html?topic=berkeley_bjc%2Fpython%2Fbesides-blocks-welcome.topic&novideo=true&noreading=true&noassignment=true&course=cs10_fa14.html&step=3

[jasnowiss]

Looking like a great lab! Awesome job Max and Andy!! A few comments:

Question 2 on the Self-Test: Math and Variables page doesn't really make sense. x = y % z y = 3 z = 2 I think the x = y % z was intended to be the last line not the first. As it is now, I believe python would throw a name error because y and z haven't been defined yet.

On the Finding a Bar page, without the introduction of for loops and ranges until a few pages later, I don't think students will understand what the problem is with the first_even_nums function, or have an idea how to fix it. I worry they might spend more time than they need to, just to realize the solution is a few pages later.

On the Defining a Simple Function page, the count_up example written in python is NOT the same as the one written in Snap because of the for loop. The snap version will say an extra item. Also, you say "to the left is the exact same function written in Snap", but the Snap example is actually on the right.

On the Printing and While Loops page, I think it would be nice to include a side-by-side image with the repeat until loop from Snap next to the while loop example.

Should we mention somewhere, either in lab, discussion, or the next python lab, the quick and easy solutions for the exponent function and reverse string function? Like exponent can be done in Python with \ and reverse string can be done with [::-1].

[jasnowiss]

Also, the while loop version of count_up won't work because the index i isn't being incremented.

[aaaschmitt]

Ok I think all of the things you mentioned are fixed jeff. Thanks for the feedback!

Andy

On Wed, Nov 5, 2014 at 3:20 PM, jasnowiss notifications@github.com wrote:

Also, the while loop version of count_up won't work because the index i isn't being incremented.

— Reply to this email directly or view it on GitHub https://github.com/beautyjoy/bjc-r/issues/480#issuecomment-61900546.