nathanwilliams-ct commented on code in PR #2202: URL: https://github.com/apache/buildstream/pull/2202#discussion_r4347892020
########## 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. Review Comment: ```suggestion Indicates that the value should be prepended to the target value, instead of the default behaviour which is to replace the target value. ``` I wouldn't use `element` to refer to the values in the yaml/bst files as the whole bst file is referred to as an 'element', which leads to confusion. This comment applies in other places below too. items in a list, key value pairs. -- 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]
