Update docs (#19)

Author: Fabulani

Quests/Publish to GitHub.md

@@ -3,11 +3,11 @@ tags:
   - quest
 class: Quest
 date_created: 2025-07-27
-description: 
+description: Publish the Nexus project to GitHub!
 type: misc
-location: 
-link: 
-status: 🕯️ pending
+location: GitHub
+link: https://github.com/Fabulani/nexus
+status: 🏆 completed
 priority: 5 ⚪
 ---
 

README.md

@@ -2,6 +2,8 @@
 
 A gamified framework for tracking projects (quests) and inventory.
 
+![Quest Screenshot](./Tutorial/Images/Publish-to-GitHub-quest-screenshot.png)
+
 ## Install
 
 The only pre-requisite is [Obsidian](https://obsidian.md/download).
@@ -30,4 +32,27 @@ And that's it! Check the `Tutorial` folder for further guidance:
 - inventory: insurance claims will be easier, better, and more accurate with a detailed account of possessions. Specific name, brand, color, receipts, and images are a plus. It also makes it easier to find where things are.
 - quests: too many ideas, projects, plans, etc. Can't keep track of them all.
 
-The inventory is not designed for very short-term or consumable items, e.g., a kitchen pantry inventory.
+The inventory is not designed for very short-term or consumable items, e.g., a kitchen pantry inventory.
+
+## Screenshots
+
+![Screenshot of an Item in the Nexus](./Tutorial/Images/Item-screenshot.png)
+
+Fig: an Item.
+
+![Screenshot of a Container in the Nexus](./Tutorial/Images/Container-screenshot.png)
+
+Fig: a Container.
+
+![Screenshot of another Quest](./Tutorial/Images/Cpp-Quest-screenshot.png)
+
+Fig: another Quest.
+
+![The Quest Log](./Tutorial/Images/Quest-log-screenshot.png)
+
+Fig: the Quest Log
+
+![The Inventory visualization in graph view](./Tutorial/Images/Graph-view-screenshot.png)
+
+Fig: inventory structure generates a nice graph view.
+

Tutorial/Images/Buttons-in-ribbon.png

@@ -1,28 +1,31 @@
-# How to use this system
+# Usage
 
-## Creating new notes
+Always use the colored buttons in the ribbon (left-side bar). There is a button for each task:
+- New Quest
+- New Item
+- New Template
+- and so on...
 
-One of these:
-- Click one of the colored buttons in the ribbon (left-side bar).
-- Use the command `QuickAdd: New <template name>` and pick one of the templates. Adjust properties in the created file.
-## Creating new templates
+![Buttons in the ribbon](./Images/Buttons-in-ribbon.png)
+
+For Quests and Inventory, set fields in the front matter as you like. You can also add additional content in the note body.
+
+## Graph View
+
+The Inventory has been structured such that the Obsidian Graph View can automatically generate a nice hierarchical view of your inventory. Every item points upwards to its container, such that they are connected in the graph. This allows you to traverse the graph and see from a glance where everything is.
+
+![Graph View inventory](./Images/Graph-view-screenshot.png)
 
-One of these:
-- Click on the `New Template` button in the ribbon.
-- Use the command `QuickAdd: New Template`.
 ## Creating new classes
 
 Metadata Menu, QuickAdd, and Templater are used for the class system:
 1. Create a note for each selector field with all possible values in `Settings/Fields`
 2. Create a file class in `Settings/Classes`. This represents a new type of class and defines the fields for the template.
-3. Use the command `QuickAdd: New Template` (or click on the button in the ribbon) to create a new template file. Wait until it prompts for adding properties, and click on the "add to end of front matter" button on the top right of the modal.
+3. Use the `New Template` button to create a new template file. Wait until it prompts for adding properties, and click on the `Add this field at the end of the front matter` button on the top right of the modal.
 4. Create a new QuickAdd template choice for creating the note.
 
-## Updating a note's front matter
-
-Easiest method is to click on the class icon button in the note and select "Insert missing fields in the front matter". It's at the bottom of the front matter.
-
-Another method is to use the command `Metadata Menu: Bulk insert missing fields` and click on the last button, "Insert at the end of the front matter".
-
+## Updating a note's front matter with new fields
 
+Easiest method is to click on the class icon button in the note and select `Insert missing fields in the front matter`. It's at the bottom of the front matter.
 
+Another method is to use the command `Metadata Menu: Bulk insert missing fields` and click on the last button, `Insert at the end of the front matter`.