Code Style

[temikfart]

Надо решить каким кодстайлом будем писать код. Предлагаю за основу как всегда брать гугловский код стайл, но с некоторыми изменениями, которые я считаю необходимыми. Например:

• Я считаю, что к типу относится & и *, поэтому считаю, что они должны писаться без пробела от названия типа, и с пробелом от идентификатора функции, переменной...

Предложения пишите в комментарии. Когда сформируем общий список, тогда сделаем Announcement.

[cann3v]

Предлагаю между телом функции и return оставлять пустую строку.

[temikfart]

Думаешь это необходимо? Мне кажется в коротких функциях всё достаточно ясно смотрится:

int foo(int a, int b) {
    std::vector<int> v(a, b);
    int t = bar(v);
    return pow(t, 2);
}

А что делать вот с такими?

int fizz(int a, int b) {
    if (a >= b) {
        std::vector<int> v(a, b);
        return buzz(v);
    }
    std::vector<int> v(b, a - 1);
    return fizzbuzz(v);
}

[cann3v]

Да это привычка со времен питона, всегда так делал. В любом случае, ведь пустыми строками отделяются логические блоки кода? Значит когда действительно необходимо, думаю, можно использовать.

[temikfart]

Ну в кодстайле об этом ничего не написано, насколько я понял, поэтому по ситуации я думаю будет нормально.

[c71n93]

@temikfart @cadnev Это конечно не про кодстайл, но предлагаю добавить обязательную документацию кода.

[cann3v]

Комментариями или ты про что?

[c71n93]

Комментариями или ты про что?

да, комментариями

[cann3v]

Так точно, командир. Обязательная документация будет.

[temikfart]

Комментариями или ты про что?

Он про doxygen. Почитай про стиль комментариев.