grim/convey

Update references.
replace-stage
2017-10-03, Eric Fritz
8dc2908ebdbd
Parents 001af33c6401
Children 4ff734b355fd2c96fdf950b8
Update references.
1 files changed, 7 insertions(+), 1 deletions(-)
  • +7 -1
    REFERENCE.md
    • --- a/REFERENCE.md Mon Oct 02 15:41:10 2017 -0500
    +++ b/REFERENCE.md Tue Oct 03 21:24:44 2017 -0500
    @@ -41,6 +41,11 @@
    This example shows how to have one file extend another, inheriting all of the plans and tasks that are
    not otherwise overwritten by the configuration file.
    +## extends-merge.yml
    +
    +This example shows how to have one file extend another and specific stages of a plan can be replaced in
    +the extending file.
    +
    ## extends-slice.yml
    This example shows how to expand an environment variable into a list in the context of a extended task.
    @@ -493,7 +498,8 @@
    | merge | | Whether or not to attempt to merge with a plan defined in the parent config file. |
    If a plan of the same name exists in a parent config file and merge is not set, it will replace the plan in its entirety. If merge is set, then
    -the stages defined in this plan will overwrite stages of the parent plan with the same name. This behavior also applies to environments.
    +the stages defined in this plan will overwrite stages of the parent plan with the same name. This behavior also applies to environments. It is an error
    +to attempt to merge a stage that does not exist in the parent and new stages cannot be added as their order would not be well defined.
    ----