Updated to make @append and @overwrite usage more clear.

Made some adjustments to the template doc in order to make the usage of `@append` and `@overwrite` more clear.
Also added an example to show that comments can be either a line comment or block comment.