July Iteration Plan

[egamma]

This plan captures what we work on during July and will ship early August.

Notice there will be a delay in 1.4 with regard to the translations and 1.4 will not be fully translated. We are planning for 1.5 to be fully translated release again.

June was a feature rich release and July is a heavy vacation month for the team. We have therefore decided that in July we will slow down feature work in favor of reducing our bug backlog and removing debt. Given this, we have the following themes for July:

• Bug/Issue management: review, cleanse, fix
• Reduce debt items
• Engage and support popular extensions. We want to make sure that popular extensions are as good as possible so we will spend time supporting these extensions with feedback and Pull Requests.
• React to feedback from the June release

The July Test Plan items are created as issues get closed.

Schedule

• July 25 Code freeze for the endgame
• July 29 endgame done

We end an iteration with an endgame. The endgame is driven by Redmond.

Monday, Jul 25

• Code freeze at 5pm PT
• Ensure we have a green build on all platforms
• All test items contain sufficiently comprehensive test descriptions by 6pm PT

Tuesday, Jul 26

• Test build starts at 7am CET / 10pm PT on Monday
• Test plan ready by 8am CET / 11pm PT on Monday
• Testing

Wednesday, Jul 27

• Testing
• Fixing (self-assigned, milestone assigned, and labeled as candidate)
• Verification

Thursday, Jul 28

• Fixing (scrutiny sets in - major bugs only - to be discussed in stand-up meeting)
• Verification
• Update release notes
  • release notes are collected in a file named Month_Year.md in this repo directory
• Add/update shrink-wrap files for built-in extensions if needed (see instructions) @Tyriar
• Update OSSREADME.json for built-in extensions based on differences to generated npm-shrinkwrap.json files if needed @Tyriar
• Run OSS tool after merging shrink-wrap findings @Tyriar
  • The LCA review of the ThirdPartyNotices.txt files is not needed anymore
• Check new OSS usage is entered into the OSS registry @Tyriar

Friday, Jul 29

• Pause scheduled insider builds @zurich
• Satellite modules/npm packages ready, version updated, smoke tested
  • vscode @bpasero
  • yo generator @aeschli
  • vsce @joaomoreno
  • node debug @weinand
• Translation input - @isdorn
• All issues verified
• Fixing (only critical bugs - no string changes)
• Smoketest
  • Windows - @weinand
  • OS X - @sandy081
  • Linux - @isidorn
• All release notes updated
  • release notes are collected in a file named Month_Year.md in this repo directory
• Acknowledge pull requests in release notes @Tyriar
• Mention notable fixes in the release notes

Monday, Aug 1

• National Day in Zurich
• Trigger new insider build and publish it manually (was delayed due to build server issue) @Tyriar
• Polish release notes @redmond

Tuesday, Aug 2

• Resubmit translation input @zurich
• Branch code with release number @zurich
• Announce master is open for business @zurich
• Publish Insider with hand-picked and reviewed candidate fixes @jrieken

Thursday/Friday, Aug 4/5

• Rebuild for all platforms (if necessary) @Tyriar
• Sanity check of installable bits
  • Windows
    • signed installer @ramya-rao-a
    • zip @ramya-rao-a
  • OS X - @chrmarti
  • Linux
    • deb packages @Tyriar
    • rpm packages 64-bit @Tyriar
    • rpm packages 32-bit @Tyriar
    • archives @Tyriar
• Publish website @gregvanl
• Publish to stable @seanmcbreen
• Git tag stable build with 1.4.0 @Tyriar
• Enable scheduled insider builds @joaomoreno
• Twitter announcement @seanmcbreen

---

Plan Items

Mark	Description
🏃	work in progress
✋	task is blocked
💪	stretch goal for this iteration

Debt Items

This section lists items to reduce our engineering debt:

• Reduce our high contrast theme CSS hacks and inline SVGs during build Inline all SVGs for the workbench when building #8516 @bpasero
  • Test Test: Reduce our high contrast theme CSS hacks and inline SVGs during build #9692
  • Release notes
• Allow to have scoped instantiation service per editor slot Allow to have scoped instantiation service per editor slot #8579 @bpasero
  • Test Test: Allow to have scoped instantiation service per editor slot #9693
  • Release notes
• Menu/title bar contribution consistency for the editor context menu @jrieken
  • Test Test: Menu/title bar contribution consistency for the editor context menu #9694
  • Release notes
• 🏃 Improve integrated terminal i18n support Improve integrated terminal #8936 @Tyriar
  • Test Test: Integrated terminal IME support  #9695
  • Release notes
• Snippet improvements Autocomplete for "console.log()" in JavaScript and TypeScript is wrong. #9072, Autocomplete (intellisense) suggestions - lower priority for code snippets #9122, Snippet suggestion triggered incorrectly #6320, Control over snippets #9286 @jrieken, @aeschli
  • Provide a setting to define the snippet sort order
    • Test Test: Provide a setting to define the snippet sort order #9696
    • Release notes
  • Provide a separate 'Insert snippet' command that allows the user to pick a snippet
    • Test Test: Provide a separate 'Insert snippet' command that allows the user to pick a snippet #9697
    • Release notes
  • Support tab completion for snippets Support for TabCompletion #9579 @jrieken
    • Test Test: Support tab completion for snippets #9698
    • Release notes

Feedback

Issues to address community feedback:

• Improve VIM support
  • 🏃 Contribute to VIM extension @rebornix
  • 🏃 Evaluate API gaps for better VIM support VIM API Gaps #8997 @Sandy, @alexandrudima, @jrieken
    • Test Test: Evaluate API gaps for better VIM support #9699
    • Release notes
• 🏃 Quick open/file list performance for large workspaces Searching large projects is too slow #55 @chrmarti
  • Test Test: Quick open/file list performance for large workspaces #9700
  • Release notes
• Editor actions are hard to discover when tabs are enabled Editor actions are hard to discover when tabs are enabled #7666 @bpasero
  • Test Test: Editor actions are hard to discover when tabs are enabled #9701
  • Release notes
• API - support group ordering for menu contributions Support group ordering #9153 @jrieken
  • Test Test: API - support group ordering for menu contributions #9702
  • Release notes
• API - support for document link provider Expose ILinkSupport in API #1805 @jrieken
  • Test Test: API - support for document link provider #9703
  • Release notes

Engineering

This section lists several engineering/development items that the team identified:

• - Add Net Promoter Score feedback support Add Net Promoter Score feedback support #9686 @joaomoreno
  • Test Test: Add Net Promoter Score feedback support #9690
• Debug: Incorporate debug protocol additions @weinand
  • Support 'Restart Frame' Debug Protocol: support 'restart frame' vscode-debugadapter-node#43
  • Support step-into-specifc Debug Protocol: Support step-into-specifc vscode-debugadapter-node#39
  • Support set-next-statement Debug protocol extension: set next statement vscode-debugadapter-node#28
  • Support paging for 'variables' request Debug protocol extension: support paging for 'variables' request vscode-debugadapter-node#31
  • Release notes
• Debug: Surface new debug protocol additions in VS Code @isidorn, @weinand
  • VSCode should only update breakpoints after save VSCode should only reset breakpoints after save when already debugging #8077
    • Test Test: Breakpoints updated only after save #9533
  • Support 'Restart Frame' Support 'Restart Frame' #9145
    • Test Test: 'Restart Frame' #9691
  • Support variable paging (aka chunked arrays) Support variable paging (aka chunked arrays) #9537
    • Test Test: 'Variable paging' #9684
  • Release notes

Explorations

• 🏃 Node debugging - investigate into supporting/switching to the Chrome Debugger Protocol that comes with node 7.0 @weinand
  • Release notes
• 🏃 Review/investigate current error telemetry @ramya-rao-a

Deferred

• Debug: Add modules view @isidorn, @weinand
• Simplify configuration support and enable to programmatically modify configurations Simplify the configuration service, enable programmatic modification #8937 @bpasero
• Add the Language Extension Checklist to our docs @kieferrm

Bugs

Bugs assigned to the current milestone:

• vscode

[johnfn]

Maybe this isn't the best place to put this, but I'm a Vim extension developer and I noticed you guys wanted to know the API gaps. I made an issue for each gap I'm aware of: #2771, #8096, #1431, #8094, #8093, #7177.

#2771 is the highest priority because it can't be worked around.

#8096 is also really important because although it can be worked around, I'm scared of breaking user's history.

The rest would be very nice to have.

[egamma]

@johnfn thanks, extracted into #8997

[egamma]

Closing - 1.4 has been shipped.

[niieani]

What came out of this exploration?

Node debugging - investigate into supporting/switching to the Chrome Debugger Protocol that comes with node 7.0 @weinand

Nothing was mentioned in the release notes :(

[egamma]

The first step was a gap analysis between the V8 node debugger adapter and the chrome debugger adapter. This is continued in August and the August plan has a link to the gap analysis.