nathanwilliams-ct commented on code in PR #2202:
URL: https://github.com/apache/buildstream/pull/2202#discussion_r4347903856


##########
doc/source/format_intro.rst:
##########
@@ -245,13 +245,15 @@ author to assert some invalid configurations.
 
 .. _format_directives_list_prepend:
 
-(<) List Prepend
+(<) Prepend
 ~~~~~~~~~~~~~~~~
-Indicates that the list should be prepended to the target list,
-instead of the default behavior which is to replace the target list.
+Indicates that the value should be prepended to the targetted element.
+If we are applying it to a list it will insert the elements in the beginning.

Review Comment:
   ```suggestion
   When applying to a list, it will insert the new list items before the target 
list items.
   ```
   
   As with https://github.com/apache/buildstream/pull/2202/changes#r4347892020 
but also using more `formal` language instead of `informal` language, to match 
rest of the documentation.
   
   This comment applies to other places too.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to