To minimize template and snippets migration efforts, follow these
guidelines:
- Don't remove or modify the original version of a template or snippet
directly; you should keep the original file pristine and always modify
your own copy. By maintaining the original version, you can easily
create the patch file of changes and clearly expose what has been
changed.
- Made clean customizations.
- Modify the minimum required number of lines. For example, don't
change the indentation of all lines.
- Adding a new line is preferable to modifying an existing line.
- Add comments that clearly document each change. Use of comments
helps to ease maintenance and comprehension of each customization.
- Try to make the customization as located as possible. Don't spread
the customization across all snippets if you can achieve the same
result by making a change in only one snippet.