Docs refactor (#9545)

* Refactor / reognaize docs structure

* Refactor plugin docs structure

* More refactoring / cleanup

* Update build images

* Gallery updates

* Order images

* Update part docs

* Settings images

* Stock images

* Reitntroduce gallery

* Add custom icon macro

* Update icons

* Cleanup

* Fix link

* Fix internal links

* Revert some page moves

* Fix links

* Fix links

src/frontend/src/components/nav/NavigationTree.tsx

@@ -142,6 +142,7 @@ export default function NavigationTree({
     (payload: RenderTreeNodePayload) => {
       return (
         <Group
+          p={3}
           justify='left'
           key={payload.node.value}
           wrap='nowrap'
@@ -151,7 +152,7 @@ export default function NavigationTree({
             }
           }}
         >
-          <Space w={5 * payload.level} />
+          <Space w={3 * payload.level} />
           <ActionIcon
             size='sm'
             variant='transparent'

src/frontend/src/defaults/links.tsx

@@ -71,7 +71,7 @@ export function getNavTabs(user: UserStateProps): NavTab[] {
 
 export const docLinks = {
   app: 'https://docs.inventree.org/app/',
-  getting_started: 'https://docs.inventree.org/en/latest/start/intro/',
+  getting_started: 'https://docs.inventree.org/en/latest/start/',
   api: 'https://docs.inventree.org/en/latest/api/api/',
   developer: 'https://docs.inventree.org/en/latest/develop/contributing/',
   faq: 'https://docs.inventree.org/en/latest/faq/',

src/frontend/src/forms/BuildForms.tsx

@@ -1,5 +1,5 @@
 import { t } from '@lingui/core/macro';
-import { Stack, Table } from '@mantine/core';
+import { Alert, List, Stack, Table } from '@mantine/core';
 import {
   IconCalendar,
   IconLink,
@@ -371,6 +371,16 @@ export function useScrapBuildOutputsForm({
     url: apiUrl(ApiEndpoints.build_output_scrap, build.pk),
     method: 'POST',
     title: t`Scrap Build Outputs`,
+    preFormContent: (
+      <Alert title={t`Scrap Build Outputs`} color='yellow'>
+        <List>
+          <List.Item>
+            {t`Selected build outputs will be completed, but marked as scrapped`}
+          </List.Item>
+          <List.Item>{t`Allocated stock items will be consumed`}</List.Item>
+        </List>
+      </Alert>
+    ),
     fields: buildOutputScrapFields,
     onFormSuccess: onFormSuccess,
     successMessage: t`Build outputs have been scrapped`,
@@ -417,6 +427,16 @@ export function useCancelBuildOutputsForm({
     url: apiUrl(ApiEndpoints.build_output_delete, build.pk),
     method: 'POST',
     title: t`Cancel Build Outputs`,
+    preFormContent: (
+      <Alert title={t`Cancel Build Outputs`} color='yellow'>
+        <List>
+          <List.Item>{t`Selected build outputs will be removed`}</List.Item>
+          <List.Item>
+            {t`Allocated stock items will be returned to stock`}
+          </List.Item>
+        </List>
+      </Alert>
+    ),
     fields: buildOutputCancelFields,
     onFormSuccess: onFormSuccess,
     successMessage: t`Build outputs have been cancelled`,

src/frontend/src/forms/StockForms.tsx

@@ -1,5 +1,14 @@
 import { t } from '@lingui/core/macro';
-import { Flex, Group, Skeleton, Stack, Table, Text } from '@mantine/core';
+import {
+  Alert,
+  Flex,
+  Group,
+  List,
+  Skeleton,
+  Stack,
+  Table,
+  Text
+} from '@mantine/core';
 import { useDisclosure } from '@mantine/hooks';
 import { modals } from '@mantine/modals';
 import {
@@ -1021,6 +1030,7 @@ function stockOperationModal({
   endpoint,
   filters,
   title,
+  preFormContent,
   successMessage,
   modalFunc = useCreateApiFormModal
 }: {
@@ -1032,6 +1042,7 @@ function stockOperationModal({
   fieldGenerator: (items: any[]) => ApiFormFieldSet;
   endpoint: ApiEndpoints;
   title: string;
+  preFormContent?: JSX.Element;
   successMessage?: string;
   modalFunc?: apiModalFunc;
 }) {
@@ -1083,6 +1094,7 @@ function stockOperationModal({
   return modalFunc({
     url: endpoint,
     fields: fields,
+    preFormContent: preFormContent,
     title: title,
     size: '80%',
     successMessage: successMessage,
@@ -1154,7 +1166,16 @@ export function useMergeStockItem(props: StockOperationProps) {
     fieldGenerator: stockMergeFields,
     endpoint: ApiEndpoints.stock_merge,
     title: t`Merge Stock`,
-    successMessage: t`Stock merged`
+    successMessage: t`Stock merged`,
+    preFormContent: (
+      <Alert title={t`Merge Stock Items`} color='yellow'>
+        <List>
+          <List.Item>{t`Merge operation cannot be reversed`}</List.Item>
+          <List.Item>{t`Tracking information may be lost when merging items`}</List.Item>
+          <List.Item>{t`Supplier information may be lost when merging items`}</List.Item>
+        </List>
+      </Alert>
+    )
   });
 }
 

src/frontend/src/pages/Index/Settings/SystemSettings.tsx

@@ -207,7 +207,8 @@ export default function SystemSettings() {
               'PART_COPY_PARAMETERS',
               'PART_COPY_TESTS',
               'PART_CATEGORY_PARAMETERS',
-              'PART_CATEGORY_DEFAULT_ICON'
+              'PART_CATEGORY_DEFAULT_ICON',
+              'PART_PARAMETER_ENFORCE_UNITS'
             ]}
           />
         )