[TYPO3-dev] phpStorm - inline comments moved by one tab after code line

[Adrien Crivelli]

I couldn't agree more with you, we need a consistent layout for the whole
project, because code writing style is very important. And there are
several rules that I am not really comfortable with, but I will comply with
them anyway, because the effort on my part is worth it
(boolean capitalization for instance doesn't make much sense to me, but
doesn't hurt either).

But I must admit that this indentation thing really bothers me more than
others... that's probably from the fact that I have never seen it in any
kind of language, or any kind of projects. That really seems like it's
coming out of nowhere. That's why I was trying to convince myself by
looking for the original reason of this rule. I guess it will just take
time to get used to it...


On 3 May 2012 14:05, Jigal van Hemert <jigal.van.hemert at typo3.org> wrote:

> Hi,
>
>
> On 3-5-2012 4:57, Adrien Crivelli wrote:
>
>> I understand the aim to "distinguish comments from code", but honestly I
>> am
>> really not fond of it. I find it breaks the visual layouts (blocks
>>
> [...]
>
>  I really don't buy the "people work all day-long with extremely
>> low-quality
>> editor" arguments.
>>
>
> I see that you are passionate about code :-)
>
> For me the main value of the formatting rules in the coding guidelines is
> that the code of all developers has the same layout. Whether I personally
> like all the rules or not is not important; the code of each and every
> developer looks the same and that increases the readability (even if you
> need to get used to it in the beginning).
>
> I use automatic formatting a lot and adjust the code afterwards manually.
> There are more areas where IDEs cannot automatically format our code (array
> definitions, function calls with long lists of parameters, etc.).
>
> Of course there are "old" parts of the core which are not completely
> following the coding guidelines. Our policy is that when a function is
> modified the formatting of the entire function should be adjusted. If you
> feel like formatting these old functions, go ahead and push a change to
> gerrit!
>
> --
> Jigal van Hemert
> TYPO3 Core Team member
>
>
> TYPO3 .... inspiring people to share!
> Get involved: typo3.org
>
> ______________________________**_________________
> TYPO3-dev mailing list
> TYPO3-dev at lists.typo3.org
> http://lists.typo3.org/cgi-**bin/mailman/listinfo/typo3-dev<http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-dev>
>