Полное или частичное документирование?
заполнять имеет смысл, если потом по этим блокам генерируется документация.
если докблок сугубо для себя, то можно опустить.
Я бы вместо 
// * Get the car record associated with the order. 
название функции переименовал бы в get_car или get_car_record