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
 (constancy evolving code)  but the
 (constancy evolving code)  but the