Create how to (#348)

* how_to_section

* how-to-before-index

* Fixed links and image sizes

* fix links and images size

* push

* kill last notion links

---------

Co-authored-by: burnettk <burnettk@users.noreply.github.com>
Co-authored-by: danfunk <daniel.h.funk@gmail.com>

docs/how_to/complete_a_task_on_behalf_of_another_user.md

@@ -21,7 +21,7 @@ This enables a smooth continuation of the process from the initial user's perspe
 
 In order to locate the active Process Instance, have a look at these pages to find an active instance to suspend.
 
-[How to find an Instance assigned to someone else](https://www.notion.so/How-to-find-an-Instance-assigned-to-someone-else-59e45e944655411581d780cf7a010230?pvs=21) 
+[How to find an Instance assigned to someone else](https://github.com/sartography/spiff-arena/blob/ec9509339470e876c57766e45eedc9e40b7b0094/docs/how_to/find_an_Instance_assigned_to_someone_else.md)
 [How to find an Instance assigned to myself](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/find_an_Instance_assigned_to_myself.md)
 
 ### Step 2: Navigate to the active User Task

docs/how_to/find_an_Instance_assigned_to_myself.md

@@ -31,3 +31,8 @@ If the Instance can not be find by searhing the list, follow these steps to sear
 
 [How to find an Instance assigned to someone else](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/find_an_Instance_assigned_to_someone_else.md) 
 
+## **Outcome**
+
+| ✅ Success                                                    | 🚫 Error                                                      |
+| ------------------------------------------------------------ | :------------------------------------------------------------ |
+| The system will then display the parent process that contains the active instance searched for. [How to view process variables](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/view_process_variables.md) | Process instance Id does not exist ![suspend_status](images/process_instance_not_found.png) Repeat Step 2 with correct Id. Note: if the instance is not active anymore, you should be able to search for it.|

docs/how_to/find_an_Instance_assigned_to_someone_else.md

@@ -29,4 +29,4 @@
 
 | ✅ Success | 🚫 Error |
 | --- | --- |
-| The system will then display the parent process<br>that contains the active instance searched for.<br>[How to view process variables](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/view_process_variables.md) | Process instance Id does not exist![Image description](images/process_instance_not_found.png) Repeat Step 2 with correct Id|
+| The system will then display the parent process that contains the active instance searched for. [How to view process variables](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/view_process_variables.md) | Process instance Id does not exist![Image description](images/process_instance_not_found.png) Repeat Step 2 with correct Id|

docs/how_to/navigate_to_an_active_process_instance.md

@@ -48,8 +48,8 @@ If the desired task or process you would like to view is not found in the parent
 
 A pop-up menu will appear. Select ‘View Call Activity Diagram’ to navigate to the sub-process.
 
-![Untitled](images/call_activity_popup.png)
-
+```{image} images/call_activity_popup.png
+```
  
 ## **Outcome**
 

docs/how_to/resume_a_process.md

@@ -4,4 +4,4 @@
 | ⚙ How do I get there \| Menu hierarchy |
 | --- |
 | Find an **active** Process Instance |
-
+| --- |

docs/how_to/suspend_a_process.md

@@ -18,7 +18,7 @@ If an instance is not active, it indicates that the process has already been com
 
 In order to locate the active Process Instance, have a look at these pages to find an active instance to suspend.
 
-[How to find an Instance assigned to someone else](https://www.notion.so/How-to-find-an-Instance-assigned-to-someone-else-59e45e944655411581d780cf7a010230?pvs=21) 
+[How to find an Instance assigned to someone else](/how_to/find_an_Instance_assigned_to_someone_else)
 [How to find an Instance assigned to myself](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/find_an_Instance_assigned_to_myself.md)
 
 ### **Step 2: Locate Icon** 

docs/how_to/view_process_variables.md

@@ -4,4 +4,3 @@
 | ⚙ How do I get there \| Menu hierarchy |
 | --- |
 | Find an **active** Process Instance |
-

docs/spiffworkflow/process_instance.md

@@ -7,7 +7,7 @@ A process instance refers to a specific occurrence. Think of a process instance
 Each Process Instance would have started at the starting point and moved on to subsequent steps. The data it collects along its path is unique to that instance. You therefor have to know how to locate a process instance. 
 
 Follow the following steps to understand how to locate a process instance:
-[How to find an Instance assigned to someone else](https://www.notion.so/How-to-find-an-Instance-assigned-to-someone-else-59e45e944655411581d780cf7a010230?pvs=21) 
+[How to find an Instance assigned to someone else](/how_to/find_an_Instance_assigned_to_someone_else)
 [How to find an Instance assigned to myself](https://github.com/sartography/spiff-arena/blob/main/docs/how_to/find_an_Instance_assigned_to_myself.md)
 
 ## ℹ Information associated with an instance