Your header file is your interface and documentation to anyone using your code/class. Why wouldn't you want to declare your public interface there? As for read

Your header file is your interface and documentation to anyone using your code/class. Why wouldn't you want to declare your public interface there? As for readability. Ruby is getting there but currently: - (void)employersWithCarrierID:(uint)carrierID withMaxReturnCount:(uint)count; [self employersWithCarrierID:123 withMaxReturnCount:10]; is a lot more readable and verbose than def employers (id, count) employer 123 10