Рассчитывайте, что ваш читатель знает Си
Не делайте чего-то подобного этому:
#define SHIFT_LEFT(x, bits) ((x) (bits))
Программисты на Си знают, что означает "сдвиг влево". Аналогично, не делайте таких вещей:
x++; // инкрементировать x
Проблема в том, что комментарии, подобные вышеуказанному, часто встречаются в учебниках по языку программирования, ибо их читатель не знаком с Си. Поэтому вы не должны делать вывод, что раз вы видите их в таком учебнике, то это является хорошей повсеместной практикой.
