Комментарии к методам

Очень понравилась фраза из SQLite coding style; не могу удержаться, чтобы не скопировать сюда:

31. Function header comment defines the behavior of the function in sufficient detail to allow the function to be reimplemented from scratch without reference to the original code.