add new locations for Tab extension point

[aalves08]

Summary

Fixes #16218

Occurred changes and/or fixed issues

• add new locations for Tab extension point:

• TabLocation.RESOURCE_DETAIL_PAGE

• TabLocation.RESOURCE_CREATE_PAGE

• TabLocation.RESOURCE_EDIT_PAGE

• TabLocation.ALL

• give deprecation notice to TabLocation.RESOURCE_DETAIL

• update documentation

Technical notes summary

Areas or cases that should be tested

Fix the imports in pkg/kubectl-explain/index.ts:

import {
  ActionLocation, IPlugin, IInternal, TabLocation
} from '@shell/core/types';

add the following bits of code to the same file:

DETAIL PAGE

plugin.addTab(
    TabLocation.RESOURCE_DETAIL_PAGE,
    { resource: ['service'] },
    {
      name:       'some-name',
      label:      'detail-page-label',
      weight:     -5,
      showHeader: true,
      tooltip:    'this is a tooltip message',
      component:  () => import('./MyTabComponent.vue')
    }
  );

CREATE PAGE

plugin.addTab(
    TabLocation.RESOURCE_CREATE_PAGE,
    { resource: ['service'] },
    {
      name:       'some-name',
      label:      'create-page-label',
      weight:     -5,
      showHeader: true,
      tooltip:    'this is a tooltip message',
      component:  () => import('./MyTabComponent.vue')
    }
  );

EDIT PAGE

plugin.addTab(
    TabLocation.RESOURCE_EDIT_PAGE,
    { resource: ['service'] },
    {
      name:       'some-name',
      label:      'edit-page-label',
      weight:     -5,
      showHeader: true,
      tooltip:    'this is a tooltip message',
      component:  () => import('./MyTabComponent.vue')
    }
  );

ALL PAGES

plugin.addTab(
    TabLocation.ALL,
    { resource: ['pod', 'service'] },
    {
      name:       'some-name',
      label:      'all-pages-label',
      weight:     -5,
      showHeader: true,
      tooltip:    'this is a tooltip message',
      component:  () => import('./MyTabComponent.vue')
    }
  );

• Check that the tabs appear fine in the mentioned areas

Areas which could experience regressions

Screenshot/Video

Checklist

• The PR is linked to an issue and the linked issue has a Milestone, or no issue is needed
• The PR has a Milestone
• The PR template has been filled out
• The PR has been self reviewed
• The PR has a reviewer assigned
• The PR has automated tests or clear instructions for manual tests and the linked issue has appropriate QA labels, or tests are not needed
• The PR has reviewed with UX and tested in light and dark mode, or there are no UX changes
• The PR has been reviewed in terms of Accessibility
• The PR has considered, and if applicable tested with, the three Global Roles Admin, Standard User and User Base

[richard-cox]

ALL RESOURCE_CREATE_PAGE, RESOURCE_EDIT_PAGE and RESOURCE_DETAIL_PAGE are also from v2.14.0