Documentation can be found on www.aircrack-ng.org
See also manpages.

Madwifi-ng known bugs:
When changing rate while you are capturing packet makes airodump stall
  Solution: restart airodump-ng or change rate before starting it
