Add Action Node docs

Author: jonnydgreen

dialogue_sequences/all.ds

@@ -64,7 +64,7 @@
       "id": "node:9",
       "type": "ACTION",
       "position": "(4040.0, 360.0)",
-      "description": "Register that Clue 1 was found",
+      "description": "Advance time [4h]",
       "action_type": "SCRIPT",
       "action_script_ref": "uid://cc7stjcigkq7f",
       "values": [

docs/latest/concepts/action-node.md

@@ -4,5 +4,5 @@ description: |
 ---
 
 This chapter goes over some fundamental concepts of Parley. It covers the
-overarching design of the Parley plugin, information about Nodes, Edges, Stores
-as well as the various features of Parley.
+overarching design of the Parley plugin, high-level information about Nodes,
+Edges, Stores as well as the various features of Parley.

docs/latest/concepts/index.md

@@ -0,0 +1,6 @@
+---
+description: |
+  Parley Runtime: TODO
+---
+
+Parley Runtime: TODO

docs/latest/concepts/parley-runtime.md

@@ -7,3 +7,5 @@ In this chapter of the Parley documentation, you can find many examples of
 Parley features. If there's a specific example you'd like to see here, please
 raise
 [a GitHub issue](https://github.com/bisterix-studio/parley/issues/new?category=ideas).
+
+- [Basic Action Node](https://github.com/bisterix-studio/parley/blob/main/examples/create-action-basic.ds)

docs/latest/examples/index.md

@@ -0,0 +1,50 @@
+---
+description: |
+  Create an Action Node
+---
+
+An Action Node gives the ability to execute functionality during the processing
+of a Dialogue Sequence. For example, emitting a signal, registering a journal
+entry, or updating state. You can find all sorts of Dialogue Sequence examples
+in the Parley
+[`examples`](https://github.com/bisterix-studio/parley/tree/main/examples)
+folder.
+
+## Pre-requisites
+
+- Ensure you have familiarised yourself with the
+  [Action Node](../nodes/action-node.md) docs.
+- Parley is installed and running in your Godot Editor.
+- You have followed the [instructions](./register-action.md) to add the relevant
+  actions to the system.
+- You have created a basic Dialogue Sequence before. Consult the
+  [getting started guide](./create-dialogue-sequence.md) for more info.
+
+## Instructions
+
+![Create an Action Node](../../../www/static/docs/create-action-node/create-action-node.gif)
+
+1. Create an Action Node using the `Insert` dropdown.
+2. Click on the created Action Node in the graph view to open up the Action Node
+   Editor.
+3. Enter a high-level descriptive name for what the Action Node represents. This
+   is because it can be sometimes hard to work out what actions are doing so the
+   more info you can provide up front the better! In this example, we write:
+   `Advance time [4h]`
+4. Choose the type of Action you want from the dropdown. In this example, we
+   choose: `Script`.
+5. Select the Action you want execute as part of this Node. In this example, we
+   choose: `Advance Time`.
+
+> [tip]: You can click on the pencil icon to the right of the Action to view the
+> selected script in the Godot GDScript editor and optionally edit it.
+
+1. Choose a value to pass to the Action Node. This must be a value understood by
+   the underlying script (chosen in the previous step). In this example, we set
+   to: `4h`.
+2. Click the `Save` button in the Parley editor and there we have it! Our first
+   dialogue sequence with an Action Node.
+3. Now connect this Node up with other Nodes to continue the Dialogue Sequence
+   with your awesome game writing!
+4. You can test out your Dialogue Sequence by clicking the Test Dialogue
+   Sequence from start button.

docs/latest/getting-started/create-action-node.md

@@ -9,12 +9,14 @@ description: |
 Condition Nodes can be used to conditionally direct users down different
 dialogue branches or even conditionally render options. They are designed to be
 infinitely nested in theory and you can find all sorts of Dialogue Sequence
-examples in the Parley `examples` folder.
+examples in the Parley
+[`examples`](https://github.com/bisterix-studio/parley/tree/main/examples)
+folder.
 
 ## Pre-requisites
 
 - Ensure you have familiarised yourself with the
-  [Condition Node](../concepts/condition-node.md) docs.
+  [Condition Node](../nodes/condition-node.md) docs.
 - Parley is installed and running in your Godot Editor.
 - You have followed the [instructions](./register-fact.md) to add the relevant
   facts to the system.

docs/latest/getting-started/create-condition-node.md

@@ -6,13 +6,16 @@ description: |
 A Dialogue Node defines a passage of dialogue for a character within the
 Dialogue Sequence. It is associated with a character which can be used to
 enhance the displayed dialogue. You can find all sorts of Dialogue Sequence
-examples in the Parley `examples` folder.
+examples in the Parley
+[`examples`](https://github.com/bisterix-studio/parley/tree/main/examples)
+folder.
 
 ## Pre-requisites
 
-- Familiarise yourself with the [Dialogue Node](../concepts/dialogue-node.md)
-  docs.
+- Familiarise yourself with the [Dialogue Node](../nodes/dialogue-node.md) docs.
 - Parley is installed and running in your Godot Editor.
+- You have followed the [instructions](./register-character.md) to add the
+  relevant characters to the system.
 - You have created a basic Dialogue Sequence before. Consult the
   [getting started guide](./create-dialogue-sequence.md) for more info.
 
@@ -23,11 +26,13 @@ examples in the Parley `examples` folder.
 1. Create a Dialogue Node using the `Insert` dropdown.
 2. Click on the created Dialogue Node in the graph view to open up the Dialogue
    Node Editor.
-3. Click the `Save` button in the Parley editor and there we have it! Our first
+3. Choose a character for your Dialogue Node form the dropdown.
+4. Write some text for your Dialogue that will be displayed to the user.
+5. Click the `Save` button in the Parley editor and there we have it! Our first
    dialogue sequence with dialogue.
-4. Now connect this Node up with other Nodes to continue the Dialogue Sequence
+6. Now connect this Node up with other Nodes to continue the Dialogue Sequence
    with your awesome game writing!
-5. You can test out your Dialogue Sequence by clicking the Test Dialogue
+7. You can test out your Dialogue Sequence by clicking the Test Dialogue
    Sequence from start button.
 
 > [tip]: You can quickly create dialogue nodes by creating an edge on the right

docs/latest/getting-started/create-dialogue-node.md

@@ -5,13 +5,17 @@ description: |
 
 A Dialogue Node defines a series of options presented to the player within the
 Dialogue Sequence. You can find all sorts of Dialogue Sequence examples in the
-Parley `examples` folder.
+Parley
+[`examples`](https://github.com/bisterix-studio/parley/tree/main/examples)
+folder.
 
 ## Pre-requisites
 
 - Familiarise yourself with the
-  [Dialogue Option Node](../concepts/dialogue-option-node.md) docs.
+  [Dialogue Option Node](../nodes/dialogue-option-node.md) docs.
 - Parley is installed and running in your Godot Editor.
+- You have followed the [instructions](./register-character.md) to add the
+  relevant characters to the system.
 - You have created a basic Dialogue Sequence before. Consult the
   [getting started guide](./create-dialogue-sequence.md) for more info.
 
@@ -23,7 +27,7 @@ Parley `examples` folder.
 2. Click on each created Dialogue Node in the graph view to open up the Dialogue
    Node Editor.
 3. Click the `Save` button in the Parley editor and there we have it! Our first
-   dialogue sequence with dialogue.
+   dialogue sequence with dialogue options.
 4. Now connect these Nodes up with other Nodes to continue the Dialogue Sequence
    with your awesome game writing!
 5. You can test out your Dialogue Sequence by clicking the Test Dialogue

docs/latest/getting-started/create-dialogue-option-node.md

@@ -4,3 +4,15 @@ description: |
 ---
 
 An Dialogue Sequence is: TODO.
+
+For more information on creating nodes within your dialogue sequences, please
+refer to the following guides:
+
+- [Create a Dialogue Node](./create-dialogue-node.md)
+- [Create a Dialogue Option Node](./create-dialogue-option-node.md)
+- [Create a Condition Node](./create-condition-node.md)
+- [Create a Match Node](./create-match-node.md)
+- [Create an Action Node](./create-action-node.md)
+- [Create a Start Node](./create-start-node.md)
+- [Create an End Node](./create-end-node.md)
+- [Create a Group Node](./create-group-node.md)