I'm new to this community and already need your help

I just started using Crazyflie and want to modify the firmware. Is there any documentation of the Source Code? It's hard to handle so much Code without documentation. I also have some other questions:
1) A question about the main-loop-frequency: In stabilizer.c (line 104) it's said that the main-loop-frequency for a kalman-estimator should be 500 Hz, however in stabilizer_types.h (line 203) the rate is defines as 1kHz. Is this a mistake or am I misunderstanding something?
2)A question about a strange behavior while flying the copter: I used an official release firmware with the cfclient and a PS3 controller. I had to set down the maximum thrust to 40% because i was testing it indoor and my flying skills were very poor and i kept overriding the thrust. After reducing I had the problem that the copter wasn't able to fly. The props started rotating but suddenly stopped after 2-3 sec for about 4-5sec regardless what inputs i was giving on the controller. After the 4-5sec i was able to rotate the props again with the same outcome. Does it have to be like, if yes why?
3)The controller is very sensitive. A deflection of 50% of my thrust-stick is already considered as maximum thrust. If i want to modify this behavior, where do i have to look in the code? Is it part of the the cfclient? Do someone also know in which file it is implemented?
Thank You
Korrelator