Comments for different extension views

src/vs/workbench/parts/extensions/electron-browser/extensionsViewlet.ts

@@ -111,6 +111,7 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  ViewsRegistry.registerViews(viewDescriptors);
  }
 
+ // View used for any kind of searching
  private createMarketPlaceExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.listView';
  return {
@@ -123,6 +124,8 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  };
  }
 
+ // Separate view for enabled extensions required as we need to show enabled, disabled and recommended sections
+ // in the default view when there is no search text, but user has installed extensions.
  private createEnabledExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.enabledExtensionList';
  return {
@@ -137,6 +140,8 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  };
  }
 
+ // Separate view for disabled extensions required as we need to show enabled, disabled and recommended sections
+ // in the default view when there is no search text, but user has installed extensions.
  private createDisabledExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.disabledExtensionList';
  return {
@@ -152,6 +157,8 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  };
  }
 
+ // Separate view for popular extensions required as we need to show popular and recommended sections
+ // in the default view when there is no search text, and user has no installed extensions.
  private createPopularExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.popularExtensionsList';
  return {
@@ -176,6 +183,9 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  }];
  }
 
+ // Separate view for recommended extensions required as we need to show it along with other views when there is no search text.
+ // When user has installed extensions, this is shown along with the views for enabled & disabled extensions
+ // When user has no installed extensions, this is shown along with the view for popular extensions
  private createDefaultRecommendedExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.recommendedList';
  return {
@@ -190,6 +200,8 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  };
  }
 
+ // Separate view for recommedations that are not workspace recommendations.
+ // Shown along with view for workspace recommendations, when using the command that shows recommendations
  private createOtherRecommendedExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.otherrecommendedList';
  return {
@@ -204,6 +216,8 @@ export class ExtensionsViewletViewsContribution implements IWorkbenchContributio
  };
  }
 
+ // Separate view for workspace recommendations.
+ // Shown along with view for other recommendations, when using the command that shows recommendations
  private createWorkspaceRecommendedExtensionsListViewDescriptor(): IViewDescriptor {
  const id = 'extensions.workspaceRecommendedList';
  return {

src/vs/workbench/parts/extensions/electron-browser/extensionsViews.ts

@@ -418,6 +418,7 @@ export class ExtensionsListView extends ViewletPanel {
  return extensions;
  }
 
+ // Get All types of recommendations, trimmed to show a max of 8 at any given time
  private getAllRecommendationsModel(query: Query, options: IQueryOptions): Promise<IPagedModel<IExtension>> {
  const value = query.value.replace(/@recommended:all/g, '').replace(/@recommended/g, '').trim().toLowerCase();
 
@@ -472,6 +473,7 @@ export class ExtensionsListView extends ViewletPanel {
  return new PagedModel([]);
  }
 
+ // Get All types of recommendations other than Workspace recommendations, trimmed to show a max of 8 at any given time
  private getRecommendationsModel(query: Query, options: IQueryOptions): Promise<IPagedModel<IExtension>> {
  const value = query.value.replace(/@recommended/g, '').trim().toLowerCase();