Is the template a minor variation on an existing one? If so, please consider improving the existing template if possible.
Is the name of the template consistent with the examples already in the library, in style ("Noun - Verb"), layout and casing?
Are all parameters in the template consistent with the examples here, including help text documented with Markdown?
Is the description of the template complete, with correct Markdown?
Is the .json filename consistent with the name of the template?
Do scripts in the template validate required arguments and fail by returning a non-zero exit code when things go wrong?
Do scripts in the template produce worthwhile status messages as they execute?
Are you happy to contribute your template under the terms of the license? If you produced the template while working for your employer please obtain written permission from them before submitting it here.
Are the default values of parameters validly applicable in other user's environments? Don't use the default values as examples if the user will have to change them
For an example of how to test your step template script body before submitting a PR take a look at this gist
Before submitting your PR, please delete everything above the line below.
Background
Results
Before
After
Pre-requisites
[ ] Id should be a GUID that is not 00000000-0000-0000-0000-000000000000
NOTE If you are modifying an existing step template, please make sure that you do not modify the Id property (updating the Id will break the Library sync functionality in Octopus).
[ ] Version should be incremented, otherwise the integration with Octopus won't update the step template correctly
[ ] Parameter names should not start with $
[ ] Step template parameter names (the ones declared in the JSON, not the script body) should be prefixed with a namespace so that they are less likely to clash with other user-defined variables in Octopus (see this issue). For example, use an abbreviated name of the step template or the category of the step template).
[ ] LastModifiedBy field must be present, and (optionally) updated with the correct author
[ ] The best practices documented here have been applied
[ ] If a new Category has been created:
[ ] An image with the name {categoryname}.png must be present under the step-templates/logos folder
[ ] The switch in the humanize function in gulpfile.babel.js must have a case statement corresponding to it
Fixes # . If there is an open issue that this PR fixes add it here, otherwise just remove this line
Step template guidelines
.json
filename consistent with the name of the template?Before submitting your PR, please delete everything above the line below.
Background
Results
Before
After
Pre-requisites
Id
should be a GUID that is not00000000-0000-0000-0000-000000000000
Id
property (updating theId
will break the Library sync functionality in Octopus).Version
should be incremented, otherwise the integration with Octopus won't update the step template correctly$
LastModifiedBy
field must be present, and (optionally) updated with the correct authorCategory
has been created:{categoryname}.png
must be present under thestep-templates/logos
folderswitch
in thehumanize
function ingulpfile.babel.js
must have acase
statement corresponding to itFixes # . If there is an open issue that this PR fixes add it here, otherwise just remove this line