updates examples and documentation (#24211)

includes better examples of valid and invalid usage of the lines
argument

fixes #22828

lib/ansible/modules/network/sros/sros_config.py

@@ -33,7 +33,8 @@ options:
         section.  The commands must be the exact same commands as found
         in the device running-config.  Be sure to note the configuration
         command syntax as some commands are automatically modified by the
-        device config parser.
+        device config parser.  The I(lines) argument only supports current
+        context lines.  See EXAMPLES
     required: false
     default: null
     aliases: ['commands']
@@ -189,6 +190,23 @@ vars:
       src: "{{ inventory_hostname }}.cfg"
       provider: "{{ cli }}"
       save: yes
+
+- name: invalid use of lines
+  sros_config:
+    lines:
+      - service
+      -     vpls 1000 customer foo 1 create
+      -         description "invalid lines example"
+    provider: "{{ cli }}"
+
+- name: valid use of lines
+  sros_config:
+    lines:
+      - description "invalid lines example"
+    parents:
+      - service
+      - vpls 1000 customer foo 1 create
+    provider: "{{ cli }}"
 """
 
 RETURN = """