OSD600 and DPS909 Winter 2018 Lab 3

From CDOT Wiki
Revision as of 13:07, 6 March 2018 by Patrick Godbout (talk | contribs) (3. Blog)
Jump to: navigation, search

Fixing a Bug In VSCode

This week we've been looking at how one approaches fixing a bug in a project like VSCode, see https://github.com/humphd/vscode/tree/good-first-experience-issue-42726#walkthrough-fixing-a-bug-in-visual-studio-code.

In this Lab, you are asked to continue your practice of these techniques, and try researching a fix to an existing bug.

A few instructions before you begin:

  • You must have already completed Lab 2
  • You may work in pairs/groups for this lab, but you must each do your own write up
  • You are not required to fully fix your bug and submit a pull request. This lab is about research, and learning the techniques and tooling only.
  • If you do fix your bug, and want to submit a pull request, please speak with me so we can co-ordinate your work with other students (i.e., so people don't take opportunities from one another).

1. Pick your Bug(s)

From the list of available VSCode Issues on GitHub, you can work on any bug you like (i.e., has the 'bug' label). Here are some suggestions of bugs that might be worth considering:

I opened some big number of files (), tried to search in them with Ctrl-Shift-F, but I got a message: spawn ENAMETOOLONG

Pick one or more bugs to work on during this lab. It's OK if other people are working on the same bug, since you're not required to submit a pull request, only do the research.

2. Research, Debug, and Try to Understand the Bug

After choosing your bug(s), try to recreate them in your dev build of vscode. What is your bug all about? Can you confirm that the bug exists? Can you reproduce it? You might have to do some work to alter your environment in order to get the bug to occur.

Try to figure out where the code is that relates to this bug. Use the Debugger, search through files in GitHub and git, look at other Issues and Pull Requests (especially closed ones) which may have code or other clues.

See if you can narrow down what is likely causing this bug.

It's OK if you can't. Keep track of all your research, guesses, what you tried, what worked, what didn't, questions you have, ideas you're exploring, etc. We'll need all that info for your blog post.

If you get really stuck, consider switching to a different bug from the list above. Don't waste a lot of time lost on a bug you can't solve. Make sure you're making progress, or switching tracks if you're stuck.

3. Can you Fix it?

After you do your research and start to locate the code related to the problem, see if you can make a fix. Your fix can be a simple one, it doesn't have to be perfect at this point: we're doing research.

What did you fix? What happened when you did? Did your fix correct the bug? Did it break anything else (other parts of the app, the tests, etc)?

Keep track of what you do.

3. Blog

Write a blog post about your experience researching and fixing a bug in VSCode. Some things you could discuss in your post:

  • Which bug(s) did you work on?
  • What was this bug about? How do you make it happen (steps to reproduce)?
  • What did you do to try and track down the cause? How close did you get?
  • What tools, techniques, approaches did you take when researching? What worked well, what didn't?
  • Were you able to do a fix? What did you change? Did it work for all cases, or was it just a start?
  • What did you learn while doing this? What kinds of things did you notice in the code that were surprising or new to you?

Please add a line for your blog in the following table:

# Name VSCode Bug(s) (URLs) Blog Post (URL)
1 Liam Newell https://github.com/Microsoft/vscode/issues/42720 http://liamnewell.me/blog/bugs/Lab-3-First-bug-analysis/
2 Matthew Quan https://github.com/Microsoft/vscode/issues/38232 https://mattprogrammingblog.wordpress.com/2018/02/23/osd600-lab-3-investigating-a-bug-with-vscode/
3 Aliaksandr Ushakou https://github.com/Microsoft/vscode/issues/43465 https://aushakou.wordpress.com/2018/02/20/researching-and-trying-to-fix-a-bug-in-vs-code/
4 Kelvin Cho https://github.com/Microsoft/vscode/issues/16834 https://klvincho.wordpress.com/2018/02/21/lab-3/
5 Jafar Frotan https://github.com/Microsoft/vscode/issues/26956 https://medium.com/@jaf.frotan/first-attempt-at-open-source-bug-9ff8662a69f8
6 Hao Chen https://github.com/Microsoft/vscode/issues/26956 https://medium.com/haorc/1-open-source-hao-0-62267bbff596
7 Lucas Verbeke https://github.com/Microsoft/vscode/issues/16834 https://thelucasexcerpt.wordpress.com/2018/02/21/osd600-lab-3-lucas-verbeke
8 Pranoy Santosh https://github.com/Microsoft/vscode/issues/36219 https://pranoydps909.blogspot.ca/2018/02/fixing-bugs-in-vscode.html
9 Evan Davies https://github.com/Microsoft/vscode/issues/39406 http://openthoughtsopensource.blogspot.ca/2018/02/bug-fixing-vscode.html
10 Oleh Hodovaniuk https://github.com/Microsoft/vscode/issues/26956 https://ohodovaniuk.wordpress.com/2018/02/22/osd600-lab-3/
11 Woodson Delhia https://github.com/Microsoft/vscode/issues/16834 https://woodsondelhia.wordpress.com/2018/02/22/strange-vscode-open-issue/
12 Yalong Li https://github.com/Microsoft/vscode/issues/44230 https://yalongxyz.blogspot.ca/2018/02/analyzing-bugs-for-vscode-on-github.html
13 Joseph Pham https://github.com/Microsoft/vscode/issues/16834 https://jpham14.wordpress.com/2018/02/15/lab-3-vscode-bug/
14 Justin Vuu https://github.com/Microsoft/vscode/issues/16834 https://justosd.wordpress.com/2018/02/23/osd600-lab-3/
15 Kevin Pham https://github.com/Microsoft/vscode/issues/16834 http://kqpham2.blogspot.ca/2018/02/vs-code-bug-fix-attempts.html
16 Abdul Kabia https://github.com/Microsoft/vscode/issues/16834 https://akkabia.wordpress.com/2018/02/24/b-but-its-right-there-vscode/
17 Owen Mak https://github.com/Microsoft/vscode/issues/16834 https://makowen.wordpress.com/2018/02/25/side-quest-fixing-bugs-in-vscode/
18 Zukhruf Khan https://github.com/Microsoft/vscode/issues/44154 https://zedsdps909blog.wordpress.com/2018/02/25/trying-to-fix-a-bug-in-vscode/
19 Alex Wang https://github.com/Microsoft/vscode/issues/42720 https://alexopensource.wordpress.com/2018/02/26/working-on-my-first-open-source-bug/
20 Bakytzhan Apetov https://github.com/Microsoft/vscode/issues/42204 https://bapetov.wordpress.com/2018/02/28/fixing-a-bug-in-vs-code/
21 Qiliang Chen https://github.com/Microsoft/vscode/pull/45002 https://qchen102.blogspot.ca/2018/02/vs-code-debugging-note-incomplete.html
22 Hongcheng Zhang https://github.com/Microsoft/vscode/issues/16834 https://hongcheng1993.wordpress.com/2018/03/03/lab3-vs_code-fix/
23 Yuriy Kartuzov https://wordpress.com/post/hongcheng1993.wordpress.com/20 https://yuriykartuzov.wordpress.com/2018/02/25/looking-for-bugs/
24 Zhihao Cai https://github.com/Microsoft/vscode/issues/26956 https://choyzhihao.wordpress.com/2018/03/01/work-with-vscode-issue/
25 Patrick Godbout https://github.com/Microsoft/vscode/issues/43302 https://mb30myopensourceblog.blogspot.ca/2018/03/finding-and-fixing-bug-in-vscode.html
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40