chore: move Table docs to components/table/table

Author: shleewhite

website/app/styles/pages/components/table.scss

@@ -3,9 +3,9 @@
  * SPDX-License-Identifier: MPL-2.0
  */
 
-// COMPONENTS > TABLE
+// COMPONENTS > TABLE > TABLE
 
-#show-content-components-table {
+#show-content-components-table-table {
   .doc-table-valign-demo {
     display: flex;
     gap: 5px;

website/docs/components/table/index.js website/docs/components/table/table/index.js

@@ -7,6 +7,7 @@ links:
   github: https://github.com/hashicorp/design-system/tree/main/packages/components/src/components/hds/table
 related:
   [
+    'components/table/advanced-table',
     'components/pagination',
     'patterns/filter-patterns',
     'patterns/table-multi-select',

website/docs/components/table/index.md website/docs/components/table/table/index.md

@@ -456,7 +456,7 @@ To create a column that has right-aligned content, set `@align` to `right` on bo
 
 ### Tooltip
 
-[Table headers](/components/table#headers) should be clear, concise, and straightforward whenever possible. However, there could be cases where the label is insufficient by itself and extra information is required. In this case, it’s possible to show a tooltip next to the label in the header:
+[Table headers](/components/table/table#headers) should be clear, concise, and straightforward whenever possible. However, there could be cases where the label is insufficient by itself and extra information is required. In this case, it’s possible to show a tooltip next to the label in the header:
 
 ```handlebars
 <Hds::Table
@@ -481,7 +481,7 @@ To create a column that has right-aligned content, set `@align` to `right` on bo
 
 Consuming a large amount of data in a tabular format can lead to an intense cognitive load for the user. As a general principle, care should be taken to simplify the information within a table as much as possible.
 
-We recommend using functionalities like [pagination](/components/pagination), [sorting](/components/table?tab=code#sortable-table), and [filtering](/patterns/filter-patterns) to reduce this load.
+We recommend using functionalities like [pagination](/components/pagination), [sorting](/components/table/table?tab=code#sortable-table), and [filtering](/patterns/filter-patterns) to reduce this load.
 
 That said, there may be cases when it’s necessary to show a table with a large number of columns and allow the user to scroll horizontally. In this case the consumer can use different approaches, depending on their context, needs and design specs.