docs(diagnostic_graph_aggregator): update document (#10199)

Signed-off-by: Mamoru Sobue <mamoru.sobue@tier4.jp>

Author: soblin

system/autoware_diagnostic_graph_aggregator/doc/format/graph.md

@@ -4,7 +4,7 @@ The graph object is the top level structure that makes up the configuration file
 
 ## Format
 
-| Name    | Type                                   | Required | Description                                   |
-| ------- | -------------------------------------- | -------- | --------------------------------------------- |
-| `files` | <code>list\[[path](./path.md)\]</code> | no       | List of path objects for importing subgraphs. |
-| `units` | <code>list\[[unit](./unit.md)\]</code> | no       | List of unit objects that make up the graph.  |
+| Name    | Type                                  | Required | Description                                   |
+| ------- | ------------------------------------- | -------- | --------------------------------------------- |
+| `files` | <code>list\[[path](./path.md)]</code> | no       | List of path objects for importing subgraphs. |
+| `units` | <code>list\[[unit](./unit.md)]</code> | no       | List of unit objects that make up the graph.  |

system/autoware_diagnostic_graph_aggregator/doc/format/unit.md

@@ -5,21 +5,25 @@ Any derived object can be used where a unit object is required.
 
 ## Format
 
-| Name   | Type     | Required | Description                                       |
-| ------ | -------- | -------- | ------------------------------------------------- |
-| `type` | `string` | yes      | The string indicating the type of derived object. |
-| `path` | `string` | no       | Any string to reference from other units.         |
+| Name                | Type     | Required | Description                                                              |
+| ------------------- | -------- | -------- | ------------------------------------------------------------------------ |
+| `path`              | `string` | no       | Any string to reference from other units.                                |
+| `type`              | `string` | yes      | The string indicating the type of derived object.                        |
+| `$derived argument` | `any`    | no       | Additional arguments for constructing the derived object of given `type` |
 
-## Derived objects
+`$derived_arguments` denotes additional arguments to be passed for constructing the object which is specified by `type` parameter. For example, if "and" is provided as `type`, `list` parameter is also required.
+
+## Derived object types
 
 - [diag](./unit/diag.md)
+- [link](./unit/link.md)
 - [and](./unit/and.md)
 - [or](./unit/or.md)
 - [remapping](./unit/remap.md)
-  - warn-to-ok
-  - warn-to-error
+  - `warn-to-ok`
+  - `warn-to-error`
 - [constant](./unit/const.md)
-  - ok
-  - warn
-  - error
-  - stale
+  - `ok`
+  - `warn`
+  - `error`
+  - `stale`

system/autoware_diagnostic_graph_aggregator/doc/format/unit/and.md

@@ -10,6 +10,8 @@ Note that error level `stale` is treated as `error`.
 | `type` | <code>string</code>                    | yes      | Specify `and` or `short-circuit-and` when using this object. |
 | `list` | <code>list\[[unit](../unit.md)]</code> | yes      | List of input unit objects.                                  |
 
+If `list` is undeclared or empty, this object is evaluated as `ok`.
+
 ## Short-circuit evaluation
 
 !!! warning

system/autoware_diagnostic_graph_aggregator/doc/format/unit/diag.md

@@ -4,7 +4,9 @@ The `diag` object is a unit that refers to a specific status within the source d
 
 ## Format
 
-| Name   | Type     | Required | Description                            |
-| ------ | -------- | -------- | -------------------------------------- |
-| `type` | `string` | yes      | Specify `diag` when using this object. |
-| `diag` | `string` | yes      | The name of the diagnostic status.     |
+| Name      | Type     | Required | Description                                   |
+| --------- | -------- | -------- | --------------------------------------------- |
+| `type`    | `string` | yes      | Specify `diag` when using this object.        |
+| `node`    | `string` | yes      | Node name that outputs the diagnostic status. |
+| `name`    | `string` | yes      | The name of the diagnostic status.            |
+| `timeout` | `float`  | yes      | The name of the diagnostic status.            |

system/autoware_diagnostic_graph_aggregator/doc/format/unit/or.md

@@ -9,3 +9,5 @@ Note that error level `stale` is treated as `error`.
 | ------ | -------------------------------------- | -------- | ------------------------------------ |
 | `type` | <code>string</code>                    | yes      | Specify `or` when using this object. |
 | `list` | <code>list\[[unit](../unit.md)]</code> | yes      | List of input unit objects.          |
+
+If `list` is undeclared or empty, this object is evaluated as `error`.