updated dcos

Author: juiwenchen

docs/source/components/directive.rst

@@ -3,7 +3,9 @@
 Directive
 =========
 
-``CodeLinks`` provides the ``src-trace`` directive and it can be used in the following ways:
+.. attention:: ``src-trace`` directive currently only supports :ref:`one-line need definition <oneline>`.
+
+``CodeLinks`` provides ``src-trace`` directive and it can be used in the following ways:
 
 .. code-block:: rst
 

docs/source/components/oneline.rst

@@ -91,14 +91,25 @@ For example, with the following **needs_fields** configuration:
 
 .. _`fields_config`:
 
-.. code-block:: python
+.. tabs::
+
+   .. code-tab:: python
+
+      needs_fields = [
+         {"name": "title"},
+         {"name": "id"},
+         {"name": "type", "default": "impl"},
+         {"name": "links", "type": "list[str]", "default": []},
+      ],
+
+   .. code-tab:: toml
 
-   needs_fields=[
-       {"name": "title"},
-       {"name": "id"},
-       {"name": "type", "default": "impl"},
-       {"name": "links", "type": "list[str]", "default": []},
-   ],
+      needs_fields = [
+         { name = "title" },
+         { name = "id" },
+         { name = "type", default = "impl" },
+         { name = "links", type = "list[str]", default = [] },
+      ]
 
 the one-line comment shall be defined as follows:
 
@@ -122,17 +133,26 @@ when it is not given in the need definition.
 
 For example, with the following needs_fields definition,
 
-.. code-block:: python
+.. tabs::
+
+   .. code-tab:: python
+
+      needs_fields = [
+         {
+            "name": "title"
+         },
+         {
+            "name": "type",
+            "default": "implementation"
+         },
+      ]
+
+   .. code-tab:: toml
 
-   needs_fields = [
-       {
-           "name": "title"
-       },
-       {
-           "name": "type",
-           "default": "implementation"
-       },
-   ]
+      needs_fields = [
+         { name = "title" },
+         { name = "type", default = "implementation" }
+      ]
 
 the following need definition in source code is equivalent to RST shown below: