Ordering Comments

[MiddleTommy]

When you have simple comments above a method or property it reorders those comments to the bottom of the class when ordering takes place.

public class Hello
{
    //this is the contructor
    public Hello(){}
}

//is reordered to
public class Hello
{
    public Hello(){}
    //this is the contructor
}

I think comments above a property, class or method that has no blank line between the comment and the code should not be reordered away from the code

[Deyan Varchev]

Hello Tommy,

Thanks for sharing your suggestion. Although it sounds logical, it will depend on the semantics of the comment whether it is for that particular method or not. Quite frequently developers comment-out large amounts of their source code (methods) and in those cases the code formatting will not work as expected. In general it is a good practice to use Doc comments (prefixed with /// in C# or ''' in VB.NET) instead of normal comments. This way, JustCode will know that the documentation is intentionally put in front of the method and will keep its correct position after formatting.

All the best,
Deyan
the Telerik team