Reorganized sidebar for Users section + mass documentation commit

.vitepress/sidebars/users.ts

@@ -8,12 +8,14 @@ export default {
       items: [
         // TODO - Finish this
         // { text: "Common Issues", link: "/users/common-issues" },
-        {
-          text: "Development Status",
-          link: "/users/development-status",
-        },
-        { text: "Supporting Create", link: "/users/support-create" },
-        { text: "View changelogs", link: "/users/changelogs/" },
+
+        //  Begin Wiki
+        //  Ponder
+         {
+           text: "Pondering",
+           link: "/users/pondering"
+         },
+
         // TODO - Redo this, it's really old and needs a update
         // {
         //   text: "How to use Create Schematics",
@@ -33,46 +35,71 @@ export default {
         //     },
         //   ],
         // },
+
+        //  Group addons/integrations together for clearer organization
         {
-          text: "Create's Computercraft Integration",
+          text: "Addons & Integrations",
           collapsed: true,
           items: [
+            //  Computer Craft (might need to restructure nesting)
             {
-              text: "Trains",
+              text: "Create's Computercraft Integration",
+              collapsed: true,
               items: [
                 {
-                  text: "Train station",
-                  link: "/users/cc-tweaked-integration/train/train-station",
+                  //  Combine into one page?
+                  text: "Trains",
+                  items: [
+                    {
+                      text: "Train station",
+                      link: "/users/cc-tweaked-integration/train/train-station",
+                    },
+                    {
+                      text: "Train schedule",
+                      link: "/users/cc-tweaked-integration/train/train-schedule",
+                    },
+                  ],
                 },
                 {
-                  text: "Train schedule",
-                  link: "/users/cc-tweaked-integration/train/train-schedule",
+                  text: "Display Link",
+                  link: "/users/cc-tweaked-integration/display-link",
+                },
+                {
+                  text: "Rotational Speed Controller",
+                  link: "/users/cc-tweaked-integration/rotational-speed-controller",
+                },
+                {
+                  text: "Sequenced Gearshift",
+                  link: "/users/cc-tweaked-integration/sequenced-gearshift",
+                },
+                {
+                  text: "Speedometer",
+                  link: "/users/cc-tweaked-integration/speedometer",
+                },
+                {
+                  text: "Stressometer",
+                  link: "/users/cc-tweaked-integration/stressometer",
                 },
               ],
             },
+            //  Other addons here
+          ]
+        },
+
+        //  Everything not related to mod guidance
+        {
+          text: "About Create",
+          collapsed: true,
+          items: [
             {
-              text: "Display Link",
-              link: "/users/cc-tweaked-integration/display-link",
-            },
-            {
-              text: "Rotational Speed Controller",
-              link: "/users/cc-tweaked-integration/rotational-speed-controller",
-            },
-            {
-              text: "Sequenced Gearshift",
-              link: "/users/cc-tweaked-integration/sequenced-gearshift",
-            },
-            {
-              text: "Speedometer",
-              link: "/users/cc-tweaked-integration/speedometer",
-            },
-            {
-              text: "Stressometer",
-              link: "/users/cc-tweaked-integration/stressometer",
+              text: "Development Status",
+              link: "/users/about/development-status",
             },
-          ],
-        },
+            { text: "Supporting Create", link: "/users/about/support-create" },
+            { text: "View changelogs", link: "/users/changelogs/" },
+          ]
+        },        
       ],
     },
   ],
-} as DefaultTheme.SidebarMulti;
+} as DefaultTheme.SidebarMulti;

users/development-status.md → users/about/development-status.md

@@ -27,4 +27,4 @@ _Supported_
 
 While the content is developed primarily on Forge, there is a dedicated team of developers maintaining a Fabric port of
 Create.  
-Their Project Page can be found [here](https://www.curseforge.com/minecraft/mc-mods/create-fabric).
+Their Project Page can be found [here](https://www.curseforge.com/minecraft/mc-mods/create-fabric).

users/pondering.md

@@ -0,0 +1,41 @@
+# Pondering
+Pondering is an in-game guide system that allows the player to quickly get information about Create blocks. The pondering screen shows an example contraption that explains the functions of the block.
+
+## Usage
+The full Ponder Index can be accessed through the Create menu by clicking the Engineer's Goggles icon in the pause menu.
+
+An item can be Pondered by hovering over it in your inventory and holding forward ("W" by default) until the bar below the item is filled up. This displays an animated infographic about the item being pondered.
+
+## Keybinds
+The keybinds for ponder are the same as those for certain player actions.
+
+|Keybind|Action|
+|---|---|
+|**Q**|Activate **Identify Mode**. This pauses the current ponder scene. Hovering over Create elements shows the name of the block and gives the option to ponder those elements.|
+|**S**|Restart the current animation.|
+|**A** or **D**|Go backwards or forwards a scene (if available).|
+|**E**|Close the animation.|
+
+Comfy Reading does not currently have a keybind, but can be enabled by tapping the button in the bottom right. This slows down the entire animation to help read the text boxes.
+
+## Navigation
+While Pondering, similar or relevant machines can be viewed by clicking the icon to the left or activating identify mode and holding W over a visible component. After moving away from the initially pondered item, the option to "Think Back" can be found at the bottom left. The player can skip to specific parts of an animation by clicking different sections of the gray bar at the bottom.
+
+## Categories
+Ponder scenes are sorted into different categories based on the pondered blocks usage and function. The different categories are:
+|Category|Description|
+|---|---|
+|Kinetic Blocks|Components which help relaying Rotational Force elsewhere|
+|Kinetic Sources|Components which generate Rotational Force|
+|Kinetic Appliances|Components which make use of Rotational Force|
+|Fluid Manipulators|Components which help relaying and making use of Fluids|
+|Item Transportation|Components which help moving items around|
+|Logic Components|Components which help with Redstone Engineering|
+|Creative Mode|Components not usually available in Survival Mode|
+|Movement Anchors|Components which allow the creation of moving Contraptions, animating an attached structure in a variety of ways.|
+|Contraption Actors|Components which expose special behavior when attached to a Contraption.|
+|Block Attachment Utility|Tools and Components used to assemble structures moved as an animated Contraption.|
+|Railway Equipment|Components used in the construction or management of Train contraptions|
+|Recent Changes|Components that have been added or changed significantly in recent versions of create|
+
+Mod authors and pack developers can add their own Ponder categories for their own purposes as well.