You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ariatosca.apache.org by "Ran Ziv (JIRA)" <ji...@apache.org> on 2017/08/07 20:55:00 UTC

[jira] [Updated] (ARIA-331) Remove "region" and "endregion" comments

     [ https://issues.apache.org/jira/browse/ARIA-331?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ran Ziv updated ARIA-331:
-------------------------
    Priority: Trivial  (was: Major)

> Remove "region" and "endregion" comments
> ----------------------------------------
>
>                 Key: ARIA-331
>                 URL: https://issues.apache.org/jira/browse/ARIA-331
>             Project: AriaTosca
>          Issue Type: Story
>            Reporter: Tal Liron
>            Priority: Trivial
>
> These add bulk rather than clarity.
> The convention is to comment at the beginning of a block, no need to "close" it and definitely not use confusing keywords that seem to belong to an IDE or preprocessor.
> So:
> {code}
> # one-to-one relationships
> ...
> {code}
> Instead of:
> {code}
> # region one-to-one relationships
> ...
> # endregion
> {code}



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)